Skip to navigation
API žinynasTasks

Create a task

View as Markdown

Queues work for the AI agent from a task template (type) about one subject of one company, e.g. { "type": "…", "subject": { "type": "company", "id": "…" } }.

Authentication

AuthorizationBearer

Skaitra API key (skt_…).

OR
AuthorizationBearer

OAuth 2.1 access token issued for the Skaitra resource (/mcp); see /.well-known/oauth-protected-resource.

Headers

Idempotency-KeystringOptional<=200 characters

Any unique value; a retry with the same key returns the first result.

Request

This endpoint expects an object.
typestringRequired1-100 characters
subjectobjectRequired
companyIdstringOptional1-200 characters
instructionstringOptional1-10000 characters

Response

OK
idstring
typestring
statusstring
attemptinteger-9007199254740991-9007199254740991
companyIdstring
companyNamestring or null
subjectobject
instructionstring
humanFeedbackstring or null
resultStatusstring or null
createdByobject
createdAtstring
updatedAtstring
completedAtstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
428
Precondition Error