Agent work

Returns every kind, always all seven in hand-out order, with its executor, the items waiting for your agent (waiting, 0 for a kind on kenso_ai), the items held by open claims (claimed), what holds the kind back (heldBy: billing_blocked, out_of_credits or ai_paused, else null) and when an answer of it was last accepted. With campaignId, the counts are that campaign's. Kinds you may not write are listed too.

Errors:

- 404 not_found: the workspace does not have the agent_work feature, or the campaign is not the workspace's. - 503 service_unavailable with Retry-After: the agent work settings could not be read. Try again.

Open to any workspace member except a Client seat.

Hands out up to limit items (1 to 50, default 10) of the first kind, in hand-out order, that waits for your agent and that you may write: only the kinds in kinds when you send it, only campaignId's work when you send it. A kind on kenso_ai, one Kenso cannot hand out yet, or one held back (heldBy) is skipped. One claim holds one kind, and one campaign for a campaign kind. The claim holds its items for leaseMinutes (5 to 240, default 30): Kenso's AI and other claims leave them alone until then. Each item carries its target, the prompt Kenso's AI would have run and what the answer must look like (answer.format json or text, and answer.schema, a JSON Schema object or null). Nothing waiting is 200 with id null and no items, and stores no claim. A claim stops short of limit when its items would pass about 900 KB; the rest stay in the queue. Send an Idempotency-Key to retry safely: a resend with the same key returns the same claim.

Errors:

- 400 validation_failed: an unknown kind, an empty kinds, or limit or leaseMinutes out of range. Each problem is one details[] entry, such as kinds[1]. - 404 not_found: the workspace does not have the agent_work feature, or the campaign is not the workspace's. - 429 rate_limited: more than 120 claims a minute or 1,800 an hour for the workspace. - 503 service_unavailable with Retry-After: the agent work settings could not be read. Nothing was handed out. Try again.

Open to any workspace member except a Client seat; hands out only the kinds the caller may write.

Takes in up to 50 answers to the claim's items: { "agent": { "cli", "model" }, "answers": [ { "itemId", "output" } ] }. output is a JSON object for a json item and a string for a text item, at most 64 KB. Returns one result per answer, in the order sent: accepted (stored where Kenso's AI would have stored it); rejected with a reason (invalid_format, too_large, unknown_item or a check the answer failed; the item is closed and its work goes back to the queue); expired (the claim ran out or was released, or the record no longer needs an answer); duplicate (the item already has an answer, or one is being taken in). Each result also has retryable: true only when Kenso could not take the answer in and the item is still held (rejected with failed_checks), so send that answer again; false for every other result. Always 200 when the claim exists, whatever each answer's result. Answer items of a claim in as many calls as you like: the claim closes once every item is answered. The agent's cli and model are saved on the claim. Send an Idempotency-Key to retry safely: an answer stored once is never stored twice.

Errors:

- 400 validation_failed: no answers, more than 50, an answer that is not an object, or an agent name over 100 characters. - 403 forbidden: you may not write the claim's kind. - 404 not_found: the workspace does not have the agent_work feature, or the claim is not the workspace's. - 429 rate_limited: more than 300 submits a minute or 6,000 an hour for the workspace.

Open to any workspace member except a Client seat who may write the claim's kind.

Gives the claim's unanswered items back to the queue now and closes the claim; answers already stored stay. Returns how many items went back. Releasing a claim that is already closed (answered, released or expired) is 200 with released 0.

Errors:

- 403 forbidden: you may not write the claim's kind. - 404 not_found: the workspace does not have the agent_work feature, or the claim is not the workspace's.

Open to any workspace member except a Client seat who may write the claim's kind.