Skip to main content
POST
/
api
/
v1
/
puppet
/
{namespace}
/
{sessionId}
/
{agentName}
/
thread
Create thread
curl --request POST \
  --url https://api.example.com/api/v1/puppet/{namespace}/{sessionId}/{agentName}/thread \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "threadName": "<string>",
  "participantNames": [
    "<string>"
  ]
}
'
{
  "thread": {
    "id": "<string>",
    "name": "<string>",
    "creatorName": "<string>",
    "participants": [
      "<string>"
    ],
    "messages": [
      {
        "id": "<string>",
        "threadId": "<string>",
        "text": "<string>",
        "senderName": "<string>",
        "mentionNames": [
          "<string>"
        ],
        "timestamp": "<string>"
      }
    ],
    "state": {
      "summary": "<string>",
      "timestamp": "<string>"
    },
    "timestamp": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.coralos.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
namespace
string
required

The session's namespace

​
sessionId
string
required

The session's ID

​
agentName
string
required

The agent's name

Body

application/json

Thread creation input

​
threadName
string
required

The name of the thread to create, this should be a short summary of the intended topic

​
participantNames
string[]
required

The list of participants to include in the thread, this should include any agent that is expected to be involved in the thread's topic. You do not need to include yourself in this list.

Response

Success

​
thread
SessionThread · object
required