---
title: "Update a Job Queue"
method: POST
path: "/queue/{uuid}.json"
tags: ["Job Queues"]
---

# Update a Job Queue

`POST /queue/{uuid}.json`

#### OAuth Scope
This endpoint requires the following OAuth scope **manage_job_queues**.

## Path parameters

- `uuid` string, uuid, required

## Request body

- Queue
  - `uuid` string, uuid — Unique identifier for this record
  - `active` 0 | 1 — Record active/deleted flag. Valid values are [0,1]
  - `edit_date` string — Timestamp at which record was last modified
  - `name` string — Name of the job queue. Used to identify the queue in the system. Examples include 'Workshop', 'Pending Quotes', etc.
  - `default_timeframe` integer — Default number of days that jobs should remain in this queue before requiring attention. Common values are 7 days (1 week) or 14 days (2 weeks).
  - `subscribed_staff` string — Semicolon-delimited list of staff UUIDs who are subscribed to receive notifications for this queue.
  - `requires_assignment` 0 | 1 — Determines if jobs in this queue require assignment to staff members. If true, jobs must be explicitly assigned to staff. If false, jobs are visible to all staff.. Valid values are [0,1]

## Response `200`

Success

- Result
  - `errorCode` number
  - `message` string

## Other responses

- `400` — Bad Request
- `default` — Unexpected error

---

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