Create a world for an agent

Create a new world for a specific agent

POST /api/agents/{agentId}/worlds

Create a world for an agent

cURL

curl --request POST \
  --url http://localhost:3000/api/agents/{agentId}/worlds \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "sourceType": "<string>",
  "sourceId": "<string>",
  "metadata": {}
}
'

201

{
  "success": true,
  "data": {
    "world": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sourceType": "<string>",
      "sourceId": "<string>",
      "metadata": {}
    }
  }
}

Path Parameters

agentId · string<uuid> · required

ID of the agent

Body

application/json

name · string

Name of the world

sourceType · string

Type of source (e.g., discord, telegram)

sourceId · string

Platform-specific identifier

metadata · object

Additional world metadata

Response

201

application/json

World created successfully

success · boolean

Example:

true

data · object

Show child attributes