> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcitable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# complete_ae_project_ticket

> Sets the status of a ticket that belongs to an Action Engine project.

Sets the status of a ticket that belongs to an Action Engine project. Accepts todo, in\_progress, or done.

Get ticketId from get\_ae\_project — the id is only served once the project is live.

Why this matters beyond a checkbox: marking a HUMAN-executor ticket done records the measurement SPOKE on the project's ledger hub, which is what makes the project's outcome delta mean anything. Agent-executed tickets do not emit a spoke, and re-submitting "done" on an already-done ticket does not double-count. Project progress is recomputed on every call.

Only tickets on a LIVE project accept changes — project status must be one of launched, measuring. Note this is STRICTER than ticket visibility (launched, measuring, done): a completed project's tickets are a readable record but a frozen one, and a call against one returns project\_not\_live. That is the rule, not a bug — do not retry.

Requires an API key with the "write" scope.

Response shape: \{ ticket: \{ id, status, executor, projectId }, progress, spokeLedgerId }. spokeLedgerId is null whenever no spoke was recorded (agent ticket, no ledger hub, or not a fresh transition into done).

Skip when: the ticket is a legacy standalone GEO ticket (use approve\_ticket / dismiss\_ticket), or the user wants to approve/launch the PROJECT itself — that gate lives in the Citable web UI.

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `ticketId` | `integer` | yes | — | Ticket id from get\_ae\_project (only served once the project is live). |
| `status` | `'todo' \| 'in_progress' \| 'done'` | yes | — | New ticket status. "done" on a human ticket records the measurement spoke. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.