--- title: Requests --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Cloudforce One](https://developers.cloudflare.com/api/python/resources/cloudforce_one) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Requests ##### [List Requests](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/list) cloudforce\_one.requests.list(RequestListParams\*\*kwargs) -> SyncSinglePage\[[ListItem]()] POST/accounts/{account\_id}/cloudforce-one/requests ##### [Get a Request](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/get) cloudforce\_one.requests.get(strrequest\_id, RequestGetParams\*\*kwargs) -> [Item]() GET/accounts/{account\_id}/cloudforce-one/requests/{request\_id} ##### [Create a New Request.](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/create) cloudforce\_one.requests.create(RequestCreateParams\*\*kwargs) -> [Item]() POST/accounts/{account\_id}/cloudforce-one/requests/new ##### [Update a Request](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/update) cloudforce\_one.requests.update(strrequest\_id, RequestUpdateParams\*\*kwargs) -> [Item]() PUT/accounts/{account\_id}/cloudforce-one/requests/{request\_id} ##### [Delete a Request](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/delete) cloudforce\_one.requests.delete(strrequest\_id, RequestDeleteParams\*\*kwargs) -> [RequestDeleteResponse]() DELETE/accounts/{account\_id}/cloudforce-one/requests/{request\_id} ##### [Get Request Quota](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/quota) cloudforce\_one.requests.quota(RequestQuotaParams\*\*kwargs) -> [Quota]() GET/accounts/{account\_id}/cloudforce-one/requests/quota ##### [Get Request Types](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/types) cloudforce\_one.requests.types(RequestTypesParams\*\*kwargs) -> SyncSinglePage\[[RequestTypesResponse]()] GET/accounts/{account\_id}/cloudforce-one/requests/types ##### [Get Request Priority, Status, and TLP constants](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/methods/constants) cloudforce\_one.requests.constants(RequestConstantsParams\*\*kwargs) -> [RequestConstants]() GET/accounts/{account\_id}/cloudforce-one/requests/constants ##### ModelsExpand 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)>)
class ListItem: … id: str UUID. maxLength36 Link to this property created: datetime Request creation time. formatdate-time Link to this property
priority: Literal\["routine", "high", "urgent"] One of the following: "routine" Link to this property "high" Link to this property "urgent" Link to this property
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 Request last updated time. formatdate-time Link to this property completed: Optional\[datetime] Request completion time. 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)%20list_item%20%3E%20(schema)>)
class Quota: … anniversary\_date: Optional\[datetime] Anniversary date is when annual quota limit is refreshed. formatdate-time Link to this property quarter\_anniversary\_date: Optional\[datetime] Quarter anniversary date is when quota limit is refreshed each quarter. formatdate-time Link to this property quota: Optional\[int] Tokens for the quarter. Link to this property remaining: Optional\[int] Tokens remaining for the quarter. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20quota%20%3E%20(schema)>)
class RequestConstants: …
priority: Optional\[List\[Literal\["routine", "high", "urgent"]]] One of the following: "routine" Link to this property "high" Link to this property "urgent" Link to this property
Link to this property
status: Optional\[List\[Literal\["open", "accepted", "reported", 3 more]]] 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
tlp: Optional\[List\[Literal\["clear", "amber", "amber-strict", 2 more]]] 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
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20request_constants%20%3E%20(schema)>) List\[[RequestTypesResponse]()] [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20request_types%20%3E%20(schema)>)
class RequestDeleteResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20request_delete_response%20%3E%20(schema)>) str Request Types. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20request_types_response%20%3E%20(schema)>) #### RequestsMessage ##### [List Request Messages](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/message/methods/get) cloudforce\_one.requests.message.get(strrequest\_id, MessageGetParams\*\*kwargs) -> SyncSinglePage\[[Message]()] POST/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/message ##### [Create a New Request Message](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/message/methods/create) cloudforce\_one.requests.message.create(strrequest\_id, MessageCreateParams\*\*kwargs) -> [Message]() POST/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/message/new ##### [Update a Request Message](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/message/methods/update) cloudforce\_one.requests.message.update(intmessage\_id, MessageUpdateParams\*\*kwargs) -> [Message]() PUT/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/message/{message\_id} ##### [Delete a Request Message](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/message/methods/delete) cloudforce\_one.requests.message.delete(intmessage\_id, MessageDeleteParams\*\*kwargs) -> [MessageDeleteResponse]() DELETE/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/message/{message\_id} ##### ModelsExpand Collapse
class Message: … id: int Message ID. Link to this property author: str Author of message. Link to this property content: str Content of message. Link to this property is\_follow\_on\_request: bool Whether the message is a follow-on request. Link to this property updated: datetime Defines the message last updated time. formatdate-time Link to this property created: Optional\[datetime] Defines the message creation time. formatdate-time Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.message%20%3E%20(model)%20message%20%3E%20(schema)>)
class MessageDeleteResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.message%20%3E%20(model)%20message_delete_response%20%3E%20(schema)>) #### RequestsPriority ##### [Get a Priority Intelligence Requirement](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/priority/methods/get) cloudforce\_one.requests.priority.get(strpriority\_id, PriorityGetParams\*\*kwargs) -> [Item]() GET/accounts/{account\_id}/cloudforce-one/requests/priority/{priority\_id} ##### [Create a New Priority Intelligence Requirement](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/priority/methods/create) cloudforce\_one.requests.priority.create(PriorityCreateParams\*\*kwargs) -> [Priority]() POST/accounts/{account\_id}/cloudforce-one/requests/priority/new ##### [Update a Priority Intelligence Requirement](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/priority/methods/update) cloudforce\_one.requests.priority.update(strpriority\_id, PriorityUpdateParams\*\*kwargs) -> [Item]() PUT/accounts/{account\_id}/cloudforce-one/requests/priority/{priority\_id} ##### [Delete a Priority Intelligence Requirement](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/priority/methods/delete) cloudforce\_one.requests.priority.delete(strpriority\_id, PriorityDeleteParams\*\*kwargs) -> [PriorityDeleteResponse]() DELETE/accounts/{account\_id}/cloudforce-one/requests/priority/{priority\_id} ##### [Get Priority Intelligence Requirement Quota](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/priority/methods/quota) cloudforce\_one.requests.priority.quota(PriorityQuotaParams\*\*kwargs) -> [Quota]() GET/accounts/{account\_id}/cloudforce-one/requests/priority/quota ##### ModelsExpand Collapse str [Link to this property](<#(resource)%20cloudforce_one.requests.priority%20%3E%20(model)%20label%20%3E%20(schema)>)
class Priority: … id: str UUID. maxLength36 Link to this property created: datetime Priority creation time. formatdate-time Link to this property labels: List\[Label] List of labels. Link to this property priority: int Priority. Link to this property requirement: str Requirement. 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 Priority last updated time. formatdate-time Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.priority%20%3E%20(model)%20priority%20%3E%20(schema)>)
class PriorityEdit: … labels: List\[Label] List of labels. Link to this property priority: int Priority. Link to this property requirement: str Requirement. 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
[Link to this property](<#(resource)%20cloudforce_one.requests.priority%20%3E%20(model)%20priority_edit%20%3E%20(schema)>)
class PriorityDeleteResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.priority%20%3E%20(model)%20priority_delete_response%20%3E%20(schema)>) #### RequestsAssets ##### [Get a Request Asset](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/assets/methods/get) cloudforce\_one.requests.assets.get(strasset\_id, AssetGetParams\*\*kwargs) -> SyncSinglePage\[[AssetGetResponse]()] GET/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/asset/{asset\_id} ##### [List Request Assets](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/assets/methods/create) cloudforce\_one.requests.assets.create(strrequest\_id, AssetCreateParams\*\*kwargs) -> SyncSinglePage\[[AssetCreateResponse]()] POST/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/asset ##### [Update a Request Asset](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/assets/methods/update) cloudforce\_one.requests.assets.update(strasset\_id, AssetUpdateParams\*\*kwargs) -> [AssetUpdateResponse]() PUT/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/asset/{asset\_id} ##### [Delete a Request Asset](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests/subresources/assets/methods/delete) cloudforce\_one.requests.assets.delete(strasset\_id, AssetDeleteParams\*\*kwargs) -> [AssetDeleteResponse]() DELETE/accounts/{account\_id}/cloudforce-one/requests/{request\_id}/asset/{asset\_id} ##### ModelsExpand Collapse
class AssetGetResponse: … id: int Asset ID. Link to this property name: str Asset name. Link to this property created: Optional\[datetime] Defines the asset creation time. formatdate-time Link to this property description: Optional\[str] Asset description. Link to this property file\_type: Optional\[str] Asset file type. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.assets%20%3E%20(model)%20asset_get_response%20%3E%20(schema)>)
class AssetCreateResponse: … id: int Asset ID. Link to this property name: str Asset name. Link to this property created: Optional\[datetime] Defines the asset creation time. formatdate-time Link to this property description: Optional\[str] Asset description. Link to this property file\_type: Optional\[str] Asset file type. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.assets%20%3E%20(model)%20asset_create_response%20%3E%20(schema)>)
class AssetUpdateResponse: … id: int Asset ID. Link to this property name: str Asset name. Link to this property created: Optional\[datetime] Defines the asset creation time. formatdate-time Link to this property description: Optional\[str] Asset description. Link to this property file\_type: Optional\[str] Asset file type. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.assets%20%3E%20(model)%20asset_update_response%20%3E%20(schema)>)
class AssetDeleteResponse: …
errors: List\[Error] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[ErrorSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property
messages: List\[Message] code: int minimum1000 Link to this property message: str Link to this property documentation\_url: Optional\[str] Link to this property
source: Optional\[MessageSource] pointer: Optional\[str] Link to this property
Link to this property
Link to this property success: Literal\[true] Whether the API call was successful. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests.assets%20%3E%20(model)%20asset_delete_response%20%3E%20(schema)>)