get_generation_status - Shipstar

Checks the generation and review state of a content record kicked off by any generate_* tool. Poll every 20–30 seconds; generation normally finishes within a few minutes.

Arguments

Name	Type	Description
`content_id`	string (UUID)	The `content_id` returned by a `generate_*` tool.

Returns

{
  "content_id": "7f5e2c1a-...",
  "output_type": "release_notes_email",
  "status": "completed",
  "error_message": null,
  "review_status": "ready_for_review",
  "is_published": false,
  "published_at": null,
  "public_slug": null,
  "created_at": "2026-08-10T14:02:11+00:00"
}

status is the generation state: pending → processing → completed, or failed (with the failure reason in error_message).
review_status is the publication state of the associated review event, when one exists: ready_for_review, approved, published, or skipped. It is null for records with no review event.

Once status is completed, read the draft with get_content_draft, then move it forward with approve_content or publish_content.

Errors

Invalid content_id (must be a UUID): abc123
Content not found: 7f5e2c1a-... — no record with that ID exists in this project.

Example prompts

“Is the changelog I kicked off done yet?”

“Check the status of content 7f5e2c1a and tell me if it failed.”