--- title: Update a Request --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Cloudforce One](https://developers.cloudflare.com/api/python/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Update a Request cloudforce\_one.requests.update(strrequest\_id, RequestUpdateParams\*\*kwargs) -> [Item]() PUT/accounts/{account\_id}/cloudforce-one/requests/{request\_id} Updating a request alters the request in the Cloudforce One queue. This API may be used to update any attributes of the request after the initial submission. Only fields that you choose to update need to be add to the request body. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `Cloudforce One Write` ##### ParametersExpand Collapse account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) request\_id: str UUID. maxLength36 [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20request_id%20%3E%20(schema)>) content: Optional\[str] Request content. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20content%20%3E%20(schema)>) priority: Optional\[str] Priority for analyzing the request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20priority%20%3E%20(schema)>) request\_type: Optional\[str] Requested information from request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20request_type%20%3E%20(schema)>) summary: Optional\[str] Brief description of the request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20summary%20%3E%20(schema)>)

tlp: Optional\[Literal\["clear", "amber", "amber-strict", 2 more]] The CISA defined Traffic Light Protocol (TLP).

One of the following: "clear" Link to this property "amber" Link to this property "amber-strict" Link to this property "green" Link to this property "red" Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20tlp%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class Item: …

id: str UUID. maxLength36 Link to this property content: str Request content. Link to this property created: datetime formatdate-time Link to this property priority: datetime formatdate-time Link to this property request: str Requested information from request. Link to this property summary: str Brief description of the request. Link to this property

tlp: Literal\["clear", "amber", "amber-strict", 2 more] The CISA defined Traffic Light Protocol (TLP).

One of the following: "clear" Link to this property "amber" Link to this property "amber-strict" Link to this property "green" Link to this property "red" Link to this property

Link to this property updated: datetime formatdate-time Link to this property completed: Optional\[datetime] formatdate-time Link to this property message\_tokens: Optional\[int] Tokens for the request messages. Link to this property readable\_id: Optional\[str] Readable Request ID. Link to this property

status: Optional\[Literal\["open", "accepted", "reported", 3 more]] Request Status.

One of the following: "open" Link to this property "accepted" Link to this property "reported" Link to this property "approved" Link to this property "completed" Link to this property "declined" Link to this property

Link to this property tokens: Optional\[int] Tokens for the request. Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20item%20%3E%20(schema)>) ### Update a Request Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) item = client.cloudforce_one.requests.update( request_id="f174e90a-fafe-4643-bbbc-4a0ed4fc8415", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(item.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "content": "What regions were most effected by the recent DoS?", "created": "2022-04-01T05:20:00Z", "priority": "2022-04-01T05:20:00Z", "request": "Victomology", "summary": "DoS attack", "tlp": "clear", "updated": "2022-04-01T05:20:00Z", "completed": "2022-04-01T05:20:00Z", "message_tokens": 1, "readable_id": "RFI-2022-000001", "status": "open", "tokens": 16 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "content": "What regions were most effected by the recent DoS?", "created": "2022-04-01T05:20:00Z", "priority": "2022-04-01T05:20:00Z", "request": "Victomology", "summary": "DoS attack", "tlp": "clear", "updated": "2022-04-01T05:20:00Z", "completed": "2022-04-01T05:20:00Z", "message_tokens": 1, "readable_id": "RFI-2022-000001", "status": "open", "tokens": 16 } } ```