This method creates the queue if it does not exist and updates the queue if it does exist.
Queues created with this method allow tasks to live for a maximum of 31 days. After a task is 31 days old, the task will be deleted regardless of whether it was dispatched or not.
WARNING: Using this method may have unintended side effects if you are using an App Enginequeue.yamlorqueue.xmlfile to manage your queues. ReadOverview of Queue Management and queue.yamlbefore using this method.
Caller-specified and required inqueues.create, after which it becomes output only.
The queue name.
The queue name must have the following format:projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID
PROJECT_IDcan contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, seeIdentifying projects
LOCATION_IDis the canonical ID for the queue's location. The list of available locations can be obtained by callinglocations.list. For more information, seehttps://cloud.google.com/about/locations/.
QUEUE_IDcan contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-05 UTC."],[],[],null,["# Method: projects.locations.queues.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a queue.\n\nThis method creates the queue if it does not exist and updates the queue if it does exist.\n\nQueues created with this method allow tasks to live for a maximum of 31 days. After a task is 31 days old, the task will be deleted regardless of whether it was dispatched or not.\n\nWARNING: Using this method may have unintended side effects if you are using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this method.\n\n### HTTP request\n\n`PATCH https://cloudtasks.googleapis.com/v2/{queue.name=projects/*/locations/*/queues/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Queue](/tasks/docs/reference/rest/v2/projects.locations.queues#Queue).\n\n### Response body\n\nIf successful, the response body contains an instance of [Queue](/tasks/docs/reference/rest/v2/projects.locations.queues#Queue).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloud-tasks`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
