Skip to main content
POST
/
api
/
memory
/
{agentId}
/
rooms
Create a room
curl --request POST \
  --url http://localhost:3000/api/memory/{agentId}/rooms \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "DM",
  "source": "client",
  "worldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "serverId": "<string>",
  "metadata": {}
}
'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": 123,
    "source": "<string>",
    "type": "<string>",
    "worldId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "serverId": "<string>",
    "metadata": {}
  }
}

Path Parameters

​
agentId
string<uuid>
required

ID of the agent

Body

application/json
​
name
string
required

Name of the room

​
type
enum<string>
default:DM

Type of room

Available options:
DM,
GROUP,
CHANNEL
​
source
string
default:client

Source of the room

​
worldId
string<uuid>

ID of the world

​
serverId
string

Server ID

​
metadata
object

Additional room metadata

Response

Room created successfully

​
success
boolean
Example:

true

​
data
object