---
title: "Create a review task"
method: POST
path: "/review-task"
tags: ["Review tasks"]
---

# Create a review task

`POST /review-task`

Creates a review task.

## Headers

- `Accept` 'application/vnd.Creative Force.v2.3+json' | 'application/vnd.Creative Force.v2.3+xml', required
- `x-api-language` string[]

## Request body

- object
  - `review_stage` string, required — Slug of the review stage. Review stages reviewed by referees cannot be used to create review tasks.
  - `entry` string, required — Slug of the entry.

## Response `200`

Review task created.

- ReviewTask — Single review task: an entry paired with a review stage, listing the reviewers responsible for actioning it.
  - `action_at` string, date-time, nullable — Date and time the review task was actioned, in ISO 8601 format. `null` when the task has not yet been actioned.
  - `category` object — Category the entry belongs to.
    - `slug` string — Short URL-safe identifier for the category.
    - `link` string, uri — Canonical URL for the category resource.
    - `name` object — Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
  - `created` string, date-time — Date and time the review task was created, in ISO 8601 format.
  - `decision` string, nullable — Decision recorded against the review task. `null` when no decision has been recorded.
  - `entry` object — Entry the review task relates to.
    - `slug` string — Short URL-safe identifier for the entry.
    - `link` string, uri — Canonical URL for the entry resource.
    - `title` string — Title of the entry.
  - `review_stage` object — Review stage the task belongs to.
    - `slug` string — Short URL-safe identifier for the review stage.
    - `link` string, uri — Canonical URL for the review stage resource.
    - `name` object — Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
  - `reviewer` object[] — Reviewers responsible for actioning the review task.
    - `name` string — Display name of the reviewer.
    - `email` string, email — Email address of the reviewer.
  - `season` object — Season the entry belongs to.
    - `slug` string — Short URL-safe identifier for the season.
    - `link` string, uri — Canonical URL for the season resource.
    - `name` object — Map keyed by locale code (for example, `en_GB` or `fr_FR`). Keys are drawn from the languages enabled on the account. Values are the translated string.
  - `token` string — Token uniquely identifying the review task.
  - `updated` string, date-time — Date and time the review task was last updated, in ISO 8601 format.

## Other responses

- `400` — Request was rejected before the endpoint could process it. Common causes: invalid `Accept` header, unsupported `x-api-language` code, empty request body on `POST` / `PUT`, invalid JSON in the request body, or an invalid slug format in a path parameter.
- `401` — Missing `x-api-key` header.
- `403` — Authenticated request denied. Common causes: invalid or unknown API key, suspended account, or `api` feature not enabled for the account.
- `422` — Request was syntactically valid but could not be processed. Returned in two scenarios: - **Field-level validation failure** — one or more request fields violated the endpoint's validation rules. The body includes an `errors` map keyed by field name with one or more validation messages each. - **Resource-state precondition failure** — the request fields were all valid, but the target resource was in a state that does not permit the requested operation. The body carries only `message` and `status_code`; no `errors` map.
- `429` — Rate limit of 60 requests per minute exceeded.
- `503` — Service is temporarily unavailable due to regional maintenance.

## Changes

- **2026-07-07** (v2) `9b9103538ceb` — 2 info
  - api tag `Review tasks` added
  - api tag `Review task` removed
- **2026-07-01** (v2) `e96a96d4507e` — 7 info
  - added the media type `application/xml` for the response with the status `200`
  - added the media type `application/xml` for the response with the status `400`
  - added the media type `application/xml` for the response with the status `401`
  - added the media type `application/xml` for the response with the status `403`
  - …3 more

[Change history](https://skmtc.dev/tectonic/apis/award-force-api/changes/review-task/post.md)

---

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