Agentic DevelopmentThreads
Create a thread
Create a thread in a project, together with its first session.
Authorization
apiKey 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.
Length
length <= 255Request 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]$Length
2 <= length <= 64project*string
Project the thread lives in
Match
^[a-z0-9][a-z0-9-]*[a-z0-9]$Length
2 <= length <= 64sharing?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"}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}