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

- QueueCreate
  - `uuid` string, uuid — Unique identifier for this record
  - `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 - The record was updated successfully

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

## Other responses

- `400` — Bad Request - The request is malformed or contains invalid parameters
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You don't have permission to update this resource
- `404` — Not Found - The record to update does not exist or has been deleted
- `429` — Too Many Requests - You have exceeded the rate limit
- `500` — Internal Server Error - An unexpected error occurred on the server

---

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