> ## 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.

# get_ae_project

> Returns ONE Action Engine project: its goal, verifiable metrics, evidence, and — when the project is live — its ticket list.

Returns ONE Action Engine project: its goal, verifiable metrics, evidence, and — when the project is live — its ticket list.

Call this FIRST whenever the user references a project by number ("project #12", "what's in the Q3 campaign"). Never answer about a specific project from the get\_ae\_projects summary alone; the goal, metrics, planned work, and ticket ids are only here.

THE VISIBILITY RULE: ticket rows come back only when project status is one of launched, measuring, done. On a proposed or approved project the response carries ticketsVisible: false and an EMPTY tickets array — this is the product working as designed, not missing data, and not a permission error. Say so plainly, name the status, and point at evidence.planned\_work, which holds the human-readable draft plan for exactly this case.

Response shape: \{ id, name, initiativeKey, status, health, progress, goalStatement, metrics, evidence, targetDate, approvedAt, launchedAt, completedAt, ticketRollup, ticketsVisible, ticketsHiddenReason, tickets: \[\{ id, code, displaySeq, shopifyProductId, title, executor, status, description }] }.

"code" is the Linear-style ticket code the user sees in the UI (GEO-078) — quote it when naming a ticket. "shopifyProductId" is set when the ticket IS a product page (the product-page project materialises one ticket per top seller), so a page's optimization run, its ticket and its code all name the same SKU.

Ticket ids from this call are what complete\_ae\_project\_ticket takes.

Skip when: the user wants the whole portfolio (get\_ae\_projects), or a legacy standalone GEO ticket (get\_geo\_priorities).

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `projectId` | `integer` | yes | — | Project id, as returned by get\_ae\_projects (the "#N" in the UI). |


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