--- title: Create a New Request. --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Cloudforce One](https://developers.cloudflare.com/api/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/requests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create a New Request. POST/accounts/{account\_id}/cloudforce-one/requests/new Creating a request adds the request into the Cloudforce One queue for analysis. In addition to the content, a short title, type, priority, and releasability should be provided. If one is not provided, a default will be assigned. ##### 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` ##### P ath ParametersExpand Collapse account\_id: string Identifier. maxLength32 [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) ##### Body ParametersJSONExpand Collapse content: optional string Request content. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20content%20%3E%20(schema)>) priority: optional string Priority for analyzing the request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20priority%20%3E%20(schema)>) request\_type: optional string Requested information from request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20request_type%20%3E%20(schema)>) summary: optional string Brief description of the request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20summary%20%3E%20(schema)>)
tlp: optional "clear"or "amber"or "amber-strict"or 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)%20create%20%3E%20(params)%200%20%3E%20(param)%20tlp%20%3E%20(schema)>) ##### ReturnsExpand Collapse
errors: array of object {code, message, documentation\_url, source } code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property
source: optional object {pointer } pointer: optional string Link to this property
Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: array of object {code, message, documentation\_url, source } code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property
source: optional object {pointer } pointer: optional string Link to this property
Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
result: optional Item { id, content, created, 10 more } id: string UUID. maxLength36 Link to this property content: string Request content. Link to this property created: string formatdate-time Link to this property priority: string formatdate-time Link to this property request: string Requested information from request. Link to this property summary: string Brief description of the request. Link to this property
tlp: "clear"or "amber"or "amber-strict"or 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: string formatdate-time Link to this property completed: optional string formatdate-time Link to this property message\_tokens: optional number Tokens for the request messages. Link to this property readable\_id: optional string Readable Request ID. Link to this property
status: optional "open"or "accepted"or "reported"or 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 number Tokens for the request. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Create a New Request. HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cloudforce-one/requests/new \ -H 'Content-Type: application/json' \ -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \ -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \ -d '{ "content": "What regions were most effected by the recent DoS?", "priority": "routine", "request_type": "Victomology", "summary": "DoS attack" }' ``` 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 } } ```