---
title: "Create a job"
method: POST
path: "/publishing/v1/jobs"
tags: ["Publishing"]
---

# Create a job

`POST /publishing/v1/jobs`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/goacoustic/apis/acoustic-content-api/docs/publishing/v1/jobs/post.ts> (a function with typed inputs; its response is checked against the schema)

Use the /jobs endpoint to create a job. The job starts automatically and runs asynchronously. Use the /jobs/current-job/status to retrieve the details about the current job status.<br />User roles: admin, manager

## Request body

- object: created job. When creating a job, you can specify mode that can be used.
  - `mode` 'UPDATE' | 'REBUILD': Specifies if the site revision will be updated or rebuilt from scratch. Default is 'UPDATE'

## Response `201`

Successfully triggered a new job.

- object
  - `links` object
    - `self` object, required: url pointing to this document
      - `href` string, required
      - `methods` string[], required
      - `name` object: single value object where key is the locale and value is the display name
  - `id` string, required: Unique identifier representing a specific item
  - `rev` string, required: a string identifying a specific version of the document
  - `created` string, date-time, required: date when this item was created
  - `creator` object, required: A reference to the User who has created the item
    - `id` string, required
  - `lastModified` string, date-time, required: date when this item was modifed for the last time
  - `lastModifier` object, required: A reference to the User who has modified the item
    - `id` string, required

## Other responses

- `400`: Unable to handle the request as it does not match the API definition.
- `429`: Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

---

[API](https://skmtc.dev/goacoustic/apis/acoustic-content-api.md) - [All operations](https://skmtc.dev/goacoustic/apis/acoustic-content-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goacoustic/apis/acoustic-content-api/revisions/677305266d89?raw)