Skip to main content
POST
Create Thread

Authorizations

x-auth-token
string
header
required

For server-to-server or automated access, use a DataGOL Service Account key. Pass it via the x-auth-token header instead of Authorization: x-auth-token: <service-account-key>

Body

application/json
name
string
required

Display name for this conversation.

Example:

"Data Summary Request"

agentType
enum<string>
required

Must be CustomAgent for custom agent conversations.

Available options:
CustomAgent
uiMetadata
object
required

Response

200 - application/json

Conversation created. Contains conversationId for the streaming endpoint.

id
string<uuid>

conversationId — pass to the streaming endpoint.

name
string
scope
string
agentType
string
active
boolean