Create

POST

/api/v1/ai-agents

Creates an AI agent with no flow. Next, save a flow with Update Flow and publish it with Publish.

A new agent does not answer any channel by itself. A workflow rule in the dashboard (Automation → Workflows, action Assign AI Agent) decides which conversations it handles.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠429Too Many Requests

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://apigw.klinkcx.com/api/v1/ai-agents' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Sales Assistant",
    "inactivityTimeout": 180
}'

Response Example

201 - Example 1

{
    "requestId": "string",
    "data": {
        "id": "string",
        "name": "string",
        "inactivityTimeout": 0,
        "hasDraft": true,
        "hasLive": true
    }
}

Modified at 2026-10-23 02:08:30

Detail

Update