---
title: "Trigger Retrospective"
method: POST
path: "/api/app-auto-gtm/projects/{project_id}/retrospectives"
tags: ["AppAutoGtm"]
---

# Trigger Retrospective

`POST /api/app-auto-gtm/projects/{project_id}/retrospectives`

Manually enqueue a project orchestrator retrospective.

Creates a `new` project_retrospective and fires the worker. Returns
scheduled=False (retrospective_id=None) when an active run already covers
the project — the partial-unique gate dedupes concurrent triggers.

An explicit manual trigger passes ``force=True`` to bypass the deploy-dark
gate (``retro_agent_enabled``) — that gate only suppresses the AUTO triggers.
Tools still honour dry-run mode, so a manual run stays non-mutating while
``retro_agent_dry_run`` is on.

## Path parameters

- `project_id` integer, required

## Cookies

- `ex_access` string, nullable
- `ex_org` string, nullable

## Response `200`

Successful Response

- TriggerRetrospectiveResponse — Body for POST /projects/{id}/retrospectives — manual orchestrator run. `retrospective_id` is None when an active retrospective already covers the project (the partial-unique gate declined a duplicate); `scheduled` reflects whether a new run was enqueued.
  - `retrospective_id` string, nullable
  - `scheduled` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explee/explee-api/revisions/aec0744a2cd1/schema)