AI Chat API — Ask Questions About Reppo

The Chat endpoint provides an AI assistant that helps you navigate the Reppo protocol. It supports multi-turn conversations via a persistent session ID and automatically selects an operating mode based on the context of your message. All Chat endpoints use the Chat Server base URL (https://api.reppo.xyz) and require a wallet session token obtained from wallet auth.

Chat mode is selected automatically based on your message content: rag for general protocol Q&A, subnet-creation for guided datanet setup, minting for the pod minting flow, and emissions for claims assistance. You do not need to specify a mode explicitly.

Send a message

POST https://api.reppo.xyz/chat Send a message and receive an AI-generated response. Omit sessionId to start a new conversation. The response includes the sessionId you should pass on follow-up turns.

Request body

string

required

Your message to the AI assistant. Maximum 4000 characters.

string

UUID of an existing session. Omit this field to start a new conversation — the response will return a fresh sessionId to use on subsequent turns.

Response

string

UUID identifying this conversation session. Pass this on subsequent requests to continue the conversation.

string

The AI-generated response. May include Markdown formatting.

array

RAG documentation sources used to generate the response.

Show source object properties

string

Source identifier or URL.

string

Title of the referenced document.

string

Section within the document.

string

The operating mode selected for this response. One of rag, subnet-creation, minting, or emissions.

Errors

Status	Meaning
`400`	Missing or invalid `message` field
`401`	Missing or expired session token
`429`	Rate limit exceeded

Examples

curl --request POST \
  --url https://api.reppo.xyz/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "What is a datanet on Reppo?"
  }'

curl --request POST \
  --url https://api.reppo.xyz/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "How do I publish a pod to that datanet?",
    "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

{
  "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "response": "A **datanet** on Reppo is a curated data collection organized around a specific topic or domain...",
  "sources": [
    {
      "source": "docs/concepts/datanets",
      "title": "Datanets",
      "section": "Overview"
    }
  ],
  "mode": "rag"
}

Get session history

GET https://api.reppo.xyz/chat/{sessionId}/history Retrieve the full message history for a conversation session. Only the wallet that created the session can access its history. Sessions expire after 30 days.

Path parameters

string

required

UUID of the conversation session to retrieve.

Response

string

UUID of the conversation session.

array

Ordered list of messages in the conversation.

Show message object properties

string

Who sent the message. Either user or assistant.

string

The message text.

string

ISO 8601 datetime when the message was sent.

string

ISO 8601 datetime when the session was created.

string

ISO 8601 datetime of the most recent message.

Errors

Status	Meaning
`401`	Missing or expired session token
`404`	Session not found or expired (sessions expire after 30 days)

Example

curl --request GET \
  --url https://api.reppo.xyz/chat/a1b2c3d4-e5f6-7890-abcd-ef1234567890/history \
  --header 'Authorization: Bearer <token>'

{
  "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "messages": [
    {
      "role": "user",
      "content": "What is a datanet on Reppo?",
      "timestamp": "2025-01-15T10:30:00Z"
    },
    {
      "role": "assistant",
      "content": "A **datanet** on Reppo is a curated data collection...",
      "timestamp": "2025-01-15T10:30:02Z"
    }
  ],
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-15T10:30:02Z"
}

Platform API

Agent API

AI Chat API — Ask Questions About Reppo

Send a message

Request body

Response

Errors

Examples

Get session history

Path parameters

Response

Errors

Example

​Send a message

​Request body

​Response

​Errors

​Examples

​Get session history

​Path parameters

​Response

​Errors

​Example

Send a message

Request body

Response

Errors

Examples

Get session history

Path parameters

Response

Errors

Example