Agentic DevelopmentThreads

Create a thread

Create a thread in a project, together with its first session.

POST
/v1/threads
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Header Parameters

Idempotency-Key?string

Optional retry-safety key, valid for 12 hours. Send the same key to retry a create safely: within that window you get the thread the first request created, answered with 200 instead of 201. Reusing a key with a different body is rejected with 422. After 12 hours the key is forgotten and the same value creates a new thread.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

org*string

Organization the project belongs to

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64
project*string

Project the thread lives in

Match^[a-z0-9][a-z0-9-]*[a-z0-9]$
Length2 <= length <= 64
sharing?string

Who beyond you may reach it. private means nobody else can open its chat.

Default"private"

Value in

  • "private"
  • "readable"
  • "writable"

Response Body

application/json

application/problem+json

curl -X POST "https://example.com/v1/threads" \  -H "Content-Type: application/json" \  -d '{    "org": "string",    "project": "string"  }'
{  "created_at": "string",  "id": "string",  "owner": {    "display_name": "string",    "id": "string",    "profile_image_url": "string",    "username": "string"  },  "project": {    "id": "string",    "name": "string",    "org": "string"  },  "sharing": "string"}