--- title: Create web or API operations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [API Gateway](https://developers.cloudflare.com/api/go/resources/api_gateway) [Operations](https://developers.cloudflare.com/api/go/resources/api_gateway/subresources/operations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Create web or API operations client.APIGateway.Operations.BulkNew(ctx, params) (\*SinglePage\[[OperationBulkNewResponse]()], error) POST/zones/{zone\_id}/api\_gateway/operations Creates one or more web or API operations. Hosts, methods, and paths are normalized; an existing matching operation is returned instead of duplicated. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
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) `Account API Gateway``Domain API Gateway` ##### ParametersExpand Collapse
params OperationBulkNewParams ZoneID param.Field\[string] Path param: Identifier. maxLength32 Link to this property
Body param.Field\[\[]OperationBulkNewParamsBody] Body param Endpoint string The endpoint which can contain path parameter templates in curly braces, each will be replaced from left to right with {varN}, starting with {var1}, during insertion. This will further be Cloudflare-normalized upon insertion. See: https://developers.cloudflare.com/rules/normalization/how-it-works/. formaturi-template maxLength4096 Link to this property Host string RFC3986-compliant host. formathostname maxLength255 Link to this property
Method OperationBulkNewParamsBodyMethod The HTTP method used to access the endpoint. One of the following: const OperationBulkNewParamsBodyMethodGet OperationBulkNewParamsBodyMethod = "GET" Link to this property const OperationBulkNewParamsBodyMethodPost OperationBulkNewParamsBodyMethod = "POST" Link to this property const OperationBulkNewParamsBodyMethodHead OperationBulkNewParamsBodyMethod = "HEAD" Link to this property const OperationBulkNewParamsBodyMethodOptions OperationBulkNewParamsBodyMethod = "OPTIONS" Link to this property const OperationBulkNewParamsBodyMethodPut OperationBulkNewParamsBodyMethod = "PUT" Link to this property const OperationBulkNewParamsBodyMethodDelete OperationBulkNewParamsBodyMethod = "DELETE" Link to this property const OperationBulkNewParamsBodyMethodConnect OperationBulkNewParamsBodyMethod = "CONNECT" Link to this property const OperationBulkNewParamsBodyMethodPatch OperationBulkNewParamsBodyMethod = "PATCH" Link to this property const OperationBulkNewParamsBodyMethodTrace OperationBulkNewParamsBodyMethod = "TRACE" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(method)%20bulk_create%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type OperationBulkNewResponse struct{…} Endpoint string The endpoint which can contain path parameter templates in curly braces, each will be replaced from left to right with {varN}, starting with {var1}, during insertion. This will further be Cloudflare-normalized upon insertion. See: https://developers.cloudflare.com/rules/normalization/how-it-works/. formaturi-template maxLength4096 Link to this property Host string RFC3986-compliant host. formathostname maxLength255 Link to this property LastUpdated Time formatdate-time Link to this property
Method OperationBulkNewResponseMethod The HTTP method used to access the endpoint. One of the following: const OperationBulkNewResponseMethodGet OperationBulkNewResponseMethod = "GET" Link to this property const OperationBulkNewResponseMethodPost OperationBulkNewResponseMethod = "POST" Link to this property const OperationBulkNewResponseMethodHead OperationBulkNewResponseMethod = "HEAD" Link to this property const OperationBulkNewResponseMethodOptions OperationBulkNewResponseMethod = "OPTIONS" Link to this property const OperationBulkNewResponseMethodPut OperationBulkNewResponseMethod = "PUT" Link to this property const OperationBulkNewResponseMethodDelete OperationBulkNewResponseMethod = "DELETE" Link to this property const OperationBulkNewResponseMethodConnect OperationBulkNewResponseMethod = "CONNECT" Link to this property const OperationBulkNewResponseMethodPatch OperationBulkNewResponseMethod = "PATCH" Link to this property const OperationBulkNewResponseMethodTrace OperationBulkNewResponseMethod = "TRACE" Link to this property
Link to this property OperationID string UUID. maxLength36 minLength36 Link to this property
Features OperationBulkNewResponseFeaturesOptional One of the following:
type OperationBulkNewResponseFeaturesAPIShieldOperationFeatureThresholds struct{…}
Thresholds OperationBulkNewResponseFeaturesAPIShieldOperationFeatureThresholdsThresholdsOptional AuthIDTokens int64Optional The total number of auth-ids seen across this calculation. Link to this property DataPoints int64Optional The number of data points used for the threshold suggestion calculation. Link to this property LastUpdated TimeOptional formatdate-time Link to this property P50 int64Optional The p50 quantile of requests (in period\_seconds). Link to this property P90 int64Optional The p90 quantile of requests (in period\_seconds). Link to this property P99 int64Optional The p99 quantile of requests (in period\_seconds). Link to this property PeriodSeconds int64Optional The period over which this threshold is suggested. Link to this property Requests int64Optional The estimated number of requests covered by these calculations. Link to this property SuggestedThreshold int64Optional The suggested threshold in requests done by the same auth\_id or period\_seconds. Link to this property
Link to this property
Link to this property
type OperationBulkNewResponseFeaturesAPIShieldOperationFeatureParameterSchemas struct{…}
ParameterSchemas OperationBulkNewResponseFeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemas LastUpdated TimeOptional formatdate-time Link to this property
ParameterSchemas OperationBulkNewResponseFeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemasParameterSchemasOptional An operation schema object containing a response. Parameters \[]unknownOptional An array containing the learned parameter schemas. Link to this property Responses unknownOptional An empty response object. This field is required to yield a valid operation schema. Link to this property
Link to this property
Link to this property
Link to this property
type OperationBulkNewResponseFeaturesAPIShieldOperationFeatureAPIRouting struct{…}
APIRouting OperationBulkNewResponseFeaturesAPIShieldOperationFeatureAPIRoutingAPIRoutingOptional API Routing settings on endpoint. LastUpdated TimeOptional formatdate-time Link to this property Route stringOptional Target route. Link to this property
Link to this property
Link to this property
type OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervals struct{…}
ConfidenceIntervals OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsOptional LastUpdated TimeOptional formatdate-time Link to this property
SuggestedThreshold OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdOptional
ConfidenceIntervals OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsOptional
P90 OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP90Optional Upper and lower bound for percentile estimate Lower float64Optional Lower bound for percentile estimate Link to this property Upper float64Optional Upper bound for percentile estimate Link to this property
Link to this property
P95 OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP95Optional Upper and lower bound for percentile estimate Lower float64Optional Lower bound for percentile estimate Link to this property Upper float64Optional Upper bound for percentile estimate Link to this property
Link to this property
P99 OperationBulkNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP99Optional Upper and lower bound for percentile estimate Lower float64Optional Lower bound for percentile estimate Link to this property Upper float64Optional Upper bound for percentile estimate Link to this property
Link to this property
Link to this property Mean float64Optional Suggested threshold. Link to this property
Link to this property
Link to this property
Link to this property
type OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfo struct{…}
SchemaInfo OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoOptional
ActiveSchema OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoActiveSchemaOptional Schema active on endpoint. ID stringOptional UUID. maxLength36 minLength36 Link to this property CreatedAt TimeOptional formatdate-time Link to this property Name stringOptional Schema file name. Link to this property
Link to this property
MitigationAction OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionOptional Action taken on requests failing validation. One of the following: const OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionNone OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "none" Link to this property const OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionLog OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "log" Link to this property const OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionBlock OperationBulkNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "block" Link to this property
Link to this property
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(model)%20OperationBulkNewResponse%20%3E%20(schema)>) ### Create web or API operations Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/api_gateway" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.APIGateway.Operations.BulkNew(context.TODO(), api_gateway.OperationBulkNewParams{ ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Body: []api_gateway.OperationBulkNewParamsBody{api_gateway.OperationBulkNewParamsBody{ Endpoint: cloudflare.F("/api/v1/users/{var1}"), Host: cloudflare.F("www.example.com"), Method: cloudflare.F(api_gateway.OperationBulkNewParamsBodyMethodGet), }}, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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" } } ], "result": [ { "endpoint": "/api/v1/users/{var1}", "host": "www.example.com", "last_updated": "2014-01-01T05:20:00.12345Z", "method": "GET", "operation_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "features": { "api_routing": { "last_updated": "2014-01-01T05:20:00.12345Z", "route": "https://api.example.com/api/service" } } } ], "success": true } ``` ##### 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" } } ], "result": [ { "endpoint": "/api/v1/users/{var1}", "host": "www.example.com", "last_updated": "2014-01-01T05:20:00.12345Z", "method": "GET", "operation_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "features": { "api_routing": { "last_updated": "2014-01-01T05:20:00.12345Z", "route": "https://api.example.com/api/service" } } } ], "success": true } ```