---
title: "Trigger a content-generation run"
method: POST
path: "/org/content-generation/run"
tags: ["Content Generation"]
---

# Trigger a content-generation run

`POST /org/content-generation/run`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/content-generation/run`
- Auth: API key in header `X-API-Key`

Triggers a manual content-generation run for the organization. With an empty body it runs all eligible prompts; otherwise it is scoped to the given prompts, content type, and destinations. Send `Content-Type: application/json` even with an empty body — the header is required (`{}` is a safe empty body). Requires the GEO product.

## Request body

- ContentGenerationRunRequest
  - `prompt_ids` string[]: Restrict the run to these prompts. Omit to run all eligible prompts.
  - `content_type_id` string, uuid: Optional content type override for the run.
  - `publisher_ids` string[]: Restrict publishing to these destinations.

## Response `202`

The run was accepted and started.

- ContentGenerationRunResponse
  - `message` string, required: Human-readable acceptance message.
  - `org_id` string, uuid, required: The organization the run belongs to.
  - `run_id` string, uuid, required: The id of the accepted run.
  - `prompt_ids` string[]: The prompts the run was scoped to, when provided.

## Other responses

- `400`: The request body was invalid — either it failed field validation (`ValidationErrorResponse`) or was otherwise malformed (`ErrorResponse`).
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.
- `409`: The request conflicts with the current state (e.g. a duplicate).
- `502`: An upstream dependency failed or rejected the request.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)