--- title: Create a New Request. --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Cloudforce One](https://developers.cloudflare.com/api/go/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/go/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. client.CloudforceOne.Requests.New(ctx, params) (\*[Item](), error) 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` ##### ParametersExpand Collapse

params RequestNewParams

AccountID param.Field\[string] Path param: Identifier. maxLength32 Link to this property Content param.Field\[string]Optional Body param: Request content. Link to this property Priority param.Field\[string]Optional Body param: Priority for analyzing the request. Link to this property RequestType param.Field\[string]Optional Body param: Requested information from request. Link to this property Summary param.Field\[string]Optional Body param: Brief description of the request. Link to this property

TLP param.Field\[RequestNewParamsTLP]Optional Body param: The CISA defined Traffic Light Protocol (TLP).

const RequestNewParamsTLPClear RequestNewParamsTLP = "clear" Link to this property const RequestNewParamsTLPAmber RequestNewParamsTLP = "amber" Link to this property const RequestNewParamsTLPAmberStrict RequestNewParamsTLP = "amber-strict" Link to this property const RequestNewParamsTLPGreen RequestNewParamsTLP = "green" Link to this property const RequestNewParamsTLPRed RequestNewParamsTLP = "red" Link to this property

Link to this property

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

type Item struct{…}

ID string UUID. maxLength36 Link to this property Content string Request content. Link to this property Created Time formatdate-time Link to this property Priority Time 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 ItemTLP The CISA defined Traffic Light Protocol (TLP).

One of the following: const ItemTLPClear ItemTLP = "clear" Link to this property const ItemTLPAmber ItemTLP = "amber" Link to this property const ItemTLPAmberStrict ItemTLP = "amber-strict" Link to this property const ItemTLPGreen ItemTLP = "green" Link to this property const ItemTLPRed ItemTLP = "red" Link to this property

Link to this property Updated Time formatdate-time Link to this property Completed TimeOptional formatdate-time Link to this property MessageTokens int64Optional Tokens for the request messages. Link to this property ReadableID stringOptional Readable Request ID. Link to this property

Status ItemStatusOptional Request Status.

One of the following: const ItemStatusOpen ItemStatus = "open" Link to this property const ItemStatusAccepted ItemStatus = "accepted" Link to this property const ItemStatusReported ItemStatus = "reported" Link to this property const ItemStatusApproved ItemStatus = "approved" Link to this property const ItemStatusCompleted ItemStatus = "completed" Link to this property const ItemStatusDeclined ItemStatus = "declined" Link to this property

Link to this property Tokens int64Optional 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)>) ### Create a New Request. Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/cloudforce_one" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) item, err := client.CloudforceOne.Requests.New(context.TODO(), cloudforce_one.RequestNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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 } } ```