Chat & runs

Send messages, stream replies, chat threads and approvals. 16 endpoints

GET /agent-runs

/api/v1/agent-runs · Needs a session

Parameters

Field	Type	Required	Notes
botId (query)	string

Example

curl -X GET 'https://api.lexcetha.com/api/v1/agent-runs' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /agent-runs

/api/v1/agent-runs · Needs a session

Request body

Field	Type	Required	Notes
conversationId	string
botId	string
message	string	yes	length 1–20000
mode	"nalar" | "patih" | "cendikia"
attachmentIds	string[]		max 5 items
mentions	object[]		max 10 items
mentions[].type	"connector" | "plugin" | "mini_program"	yes
mentions[].ref	string	yes	length 1–120
mentions[].name	string	yes	length 1–120

Example

curl -X POST 'https://api.lexcetha.com/api/v1/agent-runs' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"message":"string"}'

GET /agent-runs/{runId}

/api/v1/agent-runs/{runId} · Needs a session

Parameters

Field	Type	Required	Notes
runId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/agent-runs/:runId' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /agent-runs/{runId}/cancel

/api/v1/agent-runs/{runId}/cancel · Needs a session

Parameters

Field	Type	Required	Notes
runId (path)	string	yes

Example

curl -X POST 'https://api.lexcetha.com/api/v1/agent-runs/:runId/cancel' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /agent-runs/{runId}/tool-executions

/api/v1/agent-runs/{runId}/tool-executions · Needs a session

Parameters

Field	Type	Required	Notes
runId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/agent-runs/:runId/tool-executions' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /agent-runs/{runId}/events

/api/v1/agent-runs/{runId}/events · Needs a session

Parameters

Field	Type	Required	Notes
runId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/agent-runs/:runId/events' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /chats

/api/v1/chats · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/chats' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /chats/thread

/api/v1/chats/thread · Needs a session

Parameters

Field	Type	Required	Notes
botId (query)	string

Example

curl -X GET 'https://api.lexcetha.com/api/v1/chats/thread' \
  -H "Authorization: Bearer $LEX_TOKEN"

DELETE /chats/thread/messages

/api/v1/chats/thread/messages · Needs a session

Parameters

Field	Type	Required	Notes
botId (query)	string

Example

curl -X DELETE 'https://api.lexcetha.com/api/v1/chats/thread/messages' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /conversations

/api/v1/conversations · Needs a session

Parameters

Field	Type	Required	Notes
botId (query)	string

Example

curl -X GET 'https://api.lexcetha.com/api/v1/conversations' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /conversations/{conversationId}

/api/v1/conversations/{conversationId} · Needs a session

Parameters

Field	Type	Required	Notes
conversationId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/conversations/:conversationId' \
  -H "Authorization: Bearer $LEX_TOKEN"

PATCH /conversations/{conversationId}

/api/v1/conversations/{conversationId} · Needs a session

Parameters

Field	Type	Required	Notes
conversationId (path)	string	yes

Request body

Field	Type	Required	Notes
title	string	yes	length 1–120

Example

curl -X PATCH 'https://api.lexcetha.com/api/v1/conversations/:conversationId' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"title":"string"}'

DELETE /conversations/{conversationId}

/api/v1/conversations/{conversationId} · Needs a session

Parameters

Field	Type	Required	Notes
conversationId (path)	string	yes

Example

curl -X DELETE 'https://api.lexcetha.com/api/v1/conversations/:conversationId' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /conversations/{conversationId}/messages

/api/v1/conversations/{conversationId}/messages · Needs a session

Parameters

Field	Type	Required	Notes
conversationId (path)	string	yes

Example

curl -X GET 'https://api.lexcetha.com/api/v1/conversations/:conversationId/messages' \
  -H "Authorization: Bearer $LEX_TOKEN"

GET /approvals/pending

/api/v1/approvals/pending · Needs a session

Example

curl -X GET 'https://api.lexcetha.com/api/v1/approvals/pending' \
  -H "Authorization: Bearer $LEX_TOKEN"

POST /approvals/{approvalId}/decision

/api/v1/approvals/{approvalId}/decision · Needs a session

Parameters

Field	Type	Required	Notes
approvalId (path)	string	yes

Request body

Field	Type	Required	Notes
decision	"approve" | "reject"	yes

Example

curl -X POST 'https://api.lexcetha.com/api/v1/approvals/:approvalId/decision' \
  -H "Authorization: Bearer $LEX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"decision":"approve"}'