Run a Thread

Local

https://localhost

POST

/api/v1/threads/{thread_uuid}/run

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Query Params

Header Params

Body Params application/json

Examples

Responses

🟢200JSON

application/json

Body

🟢200Stream

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://localhost/api/v1/threads//run?workspace_uuid={{workspace_uuid}}' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "provider": "openai",
    "model": "gpt-4.1-mini",
    "agent_uuid": "{{agent_uuid}}"
}'

Response Example

200 - JSON - Example 1

{
    "id": "chatcmpl-123abc",
    "content": "Hello! How can I help you today?",
    "metadata": {
        "tool_calls": [
            {
                "id": "call_abc123",
                "type": "function",
                "function": {
                    "name": "search_web",
                    "arguments": "{\"query\": \"weather in Paris\"}"
                }
            }
        ]
    }
}

Modified at 2025-06-20 02:39:23

Create a Thread

Generate Thread Name