Start a session
Start an agent session in a project. The response returns as soon as the session is recorded; the agent starts working afterwards.
Start an agent session in a project. The response returns as soon as the session is recorded; the agent starts working afterwards.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Header Parameters
Optional retry-safety key, valid for 12 hours. Send the same key to retry a create safely: within that window you get the session the first request created, answered with 200 instead of 201, and no second agent run is started. Reusing a key with a different body is rejected with 422. After 12 hours the key is forgotten and the same value starts a new session.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Organization the project belongs to
Project the session runs in
The first message to the agent
1 <= length <= 32768Response Body
application/json
application/problem+json
curl -X POST "https://example.com/v1/sessions" \ -H "Content-Type: application/json" \ -d '{ "org": "string", "project": "string", "prompt": "string" }'{ "archived_at": "string", "created_at": "string", "id": "string", "last_turn_ended_at": "string", "project": { "id": "string", "name": "string", "org": "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"}