---
title: "Get a sample generation job"
method: GET
path: "/org/content-generation/sample-jobs/{sample_job_id}"
tags: ["Content Generation"]
---

# Get a sample generation job

`GET /org/content-generation/sample-jobs/{sample_job_id}`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/content-generation/sample-jobs/{sample_job_id}`
- Auth: API key in header `X-API-Key`

Polls an async sample-generation job (submitted via `POST /org/content-generation/sample`). A `completed` job carries the generated content in `result`; a `failed` job carries a safe `error` summary. Requires the GEO product.

## Path parameters

- `sample_job_id` string, uuid, required

## Response `200`

The sample job's current state.

- ContentGenerationSampleJobResponse: An async sample-generation job and, once finished, its outcome.
  - `sample_job_id` string, uuid, required
  - `org_id` string, uuid, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'expired', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `started_at` string, date-time
  - `completed_at` string, date-time
  - `result` ContentGenerationSampleResult: The content a completed sample-generation job produced.
    - `content_id` string, uuid, required
    - `version_id` string, uuid, required
    - `version_num` integer, required
    - `raw_markdown` string, required
    - `seo_title` string, required
    - `url_slug` string, required
    - `meta_data` unknown, required
    - `json_ld` unknown, required
    - `editorial_status` string, required: The content's editorial state (e.g. `draft`, `published`).
    - `publish_status` string, required: The overall publish outcome, when publishing was attempted.
    - `publish_destination` string: The destination slug the sample was asked to publish to, when one was requested.
    - `publish_results` ContentGenerationPublishResult[]: Per-destination publish outcomes; present once publishing was attempted.
      - `publisher` string, required
      - `display_url` string
      - `status` string, required
      - `error_msg` string
    - `publish_error` string: The publish failure, when publishing failed.
  - `error` ContentGenerationSampleJobError: A safe description of why a sample-generation job failed.
    - `code` string: A stable machine-readable failure code, when one was recorded.
    - `message` string, required

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `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.
- `404`: The requested resource does not exist or is not visible to this key.

---

[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)