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

# Create a job

`POST /publishing/v1/jobs`

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.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)