# API V2 (New)

## Part 1. Data Schema 

{% content-ref url="/pages/M1dtqsT4rHDaTugU2b1Q" %}
[Understand the data schema](/dev-docs/data-schema/understand-the-data-schema.md)
{% endcontent-ref %}

If you've read [Understand the data schema](/dev-docs/data-schema/understand-the-data-schema.md) already, in V2 API, we renamed "Scene" to "Chapter", and "NPC" to "Character".

## Part 2. Game Control - Manage the User Experience in Game

* Get Game Data
* Start Game
* Switch Chapters
* Continue Sessions (Game progress memory)

{% content-ref url="/pages/RIeEzH0QHIehue7FN6FT" %}
[Game Control](/dev-docs/player-api/api-overview/api-v2-new/game-control.md)
{% endcontent-ref %}

## Part 3. Chat with NPCs & Check Goal with SSE - What's in SSE

* Chat with NPCs in SSE (single chat, group chat)
* Normal NPC Conversations
* Game Control Messages AI Powered Goal Check

{% content-ref url="/pages/cgYpBaNNMeU7HLkS3H5S" %}
[Chat with NPCs & Check Goal with SSE](/dev-docs/player-api/api-overview/api-v2-new/chat-with-npcs-and-check-goal-with-sse.md)
{% endcontent-ref %}

* **Async via SSE:** V1 provides synced api call only. But V2, we turn to async msg push, which means all the generation will be pushed to client via SSE.

## Part 4. Multi-modal Output

* V2 support image, audio, music generation in real-time. 
* Currently its a whitelist logic under gameid, request for multi-modal game experience by sending us your GameId, <mark style="color:blue;"><dev@rpggo.ai></mark>
* Sample game for Multi-modal output <https://rpggo.ai/game/25e19be0-2b17-47e9-9891-d12a7131506b#/game?gameId=25e19be0-2b17-47e9-9891-d12a7131506b>

## Part 5. Game List Authorization

* You can only access permission-granted games.
* Let us know if you are interested in any GameId or a GameId list.  send request to <mark style="color:blue;"><dev@rpggo.ai></mark>

## Part 6. Sample Code

* Here is an example of node.js to play with our V2 API.  [Simple Chat Game with V2 API](/dev-docs/open-source-use-cases/simple-chat-game-with-v2-api.md)

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rpggo.ai/dev-docs/player-api/api-overview/api-v2-new.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.