--- title: Create web or API operations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [API Gateway](https://developers.cloudflare.com/api/typescript/resources/api_gateway) [Operations](https://developers.cloudflare.com/api/typescript/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.bulkCreate(OperationBulkCreateParams {zone\_id, body } params, RequestOptionsoptions?): SinglePage< [OperationBulkCreateResponse]() {endpoint, host, last\_updated, 3 more } > 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: OperationBulkCreateParams {zone\_id, body }

zone\_id: string Path param: Identifier. maxLength32 Link to this property

body: Array<Body> 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: "GET"| "POST"| "HEAD"| 6 more The HTTP method used to access the endpoint.

One of the following: "GET" Link to this property "POST" Link to this property "HEAD" Link to this property "OPTIONS" Link to this property "PUT" Link to this property "DELETE" Link to this property "CONNECT" Link to this property "PATCH" Link to this property "TRACE" 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

OperationBulkCreateResponse {endpoint, host, last\_updated, 3 more }

method: "GET"| "POST"| "HEAD"| 6 more The HTTP method used to access the endpoint.

Link to this property operation\_id: string UUID. maxLength36 minLength36 Link to this property

features?: APIShieldOperationFeatureThresholds {thresholds } | APIShieldOperationFeatureParameterSchemas {parameter\_schemas } | APIShieldOperationFeatureAPIRouting {api\_routing } | 2 more

One of the following:

APIShieldOperationFeatureThresholds {thresholds }

thresholds?: Thresholds {auth\_id\_tokens, data\_points, last\_updated, 6 more }

auth\_id\_tokens?: number The total number of auth-ids seen across this calculation. Link to this property data\_points?: number The number of data points used for the threshold suggestion calculation. Link to this property last\_updated?: string formatdate-time Link to this property p50?: number The p50 quantile of requests (in period\_seconds). Link to this property p90?: number The p90 quantile of requests (in period\_seconds). Link to this property p99?: number The p99 quantile of requests (in period\_seconds). Link to this property period\_seconds?: number The period over which this threshold is suggested. Link to this property requests?: number The estimated number of requests covered by these calculations. Link to this property suggested\_threshold?: number The suggested threshold in requests done by the same auth\_id or period\_seconds. Link to this property

Link to this property

APIShieldOperationFeatureParameterSchemas {parameter\_schemas }

parameter\_schemas: ParameterSchemas {last\_updated, parameter\_schemas }

last\_updated?: string formatdate-time Link to this property

parameter\_schemas?: ParameterSchemas {parameters, responses } An operation schema object containing a response.

parameters?: Array<unknown> An array containing the learned parameter schemas. Link to this property responses?: unknown An empty response object. This field is required to yield a valid operation schema. Link to this property

Link to this property

APIShieldOperationFeatureAPIRouting {api\_routing }

api\_routing?: APIRouting {last\_updated, route } API Routing settings on endpoint.

last\_updated?: string formatdate-time Link to this property route?: string Target route. Link to this property

Link to this property

APIShieldOperationFeatureConfidenceIntervals {confidence\_intervals }

confidence\_intervals?: ConfidenceIntervals {last\_updated, suggested\_threshold }

last\_updated?: string formatdate-time Link to this property

suggested\_threshold?: SuggestedThreshold {confidence\_intervals, mean }

confidence\_intervals?: ConfidenceIntervals {p90, p95, p99 }

p90?: P90 {lower, upper } Upper and lower bound for percentile estimate

lower?: number Lower bound for percentile estimate Link to this property upper?: number Upper bound for percentile estimate Link to this property

Link to this property

p95?: P95 {lower, upper } Upper and lower bound for percentile estimate

lower?: number Lower bound for percentile estimate Link to this property upper?: number Upper bound for percentile estimate Link to this property

Link to this property

p99?: P99 {lower, upper } Upper and lower bound for percentile estimate

lower?: number Lower bound for percentile estimate Link to this property upper?: number Upper bound for percentile estimate Link to this property

Link to this property

Link to this property mean?: number Suggested threshold. Link to this property

Link to this property

APIShieldOperationFeatureSchemaInfo {schema\_info }

schema\_info?: SchemaInfo {active\_schema, mitigation\_action }

active\_schema?: ActiveSchema {id, created\_at, name } Schema active on endpoint.

id?: string UUID. maxLength36 minLength36 Link to this property created\_at?: string formatdate-time Link to this property name?: string Schema file name. Link to this property

Link to this property

mitigation\_action?: "none"| "log"| "block"| null Action taken on requests failing validation.

One of the following: "none" Link to this property "log" Link to this property "block" Link to this property

Link to this property

[Link to this property](<#(resource)%20api_gateway.operations%20%3E%20(model)%20operation_bulk_create_response%20%3E%20(schema)>) ### Create web or API operations TypeScript HTTPTypeScriptPythonGoTerraform ``` import Cloudflare from 'cloudflare'; const client = new Cloudflare({ apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const operationBulkCreateResponse of client.apiGateway.operations.bulkCreate({ zone_id: '023e105f4ecef8ad9ca31a8372d0c353', body: [ { endpoint: '/api/v1/users/{var1}', host: 'www.example.com', method: 'GET', }, ], })) { console.log(operationBulkCreateResponse.operation_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" } } ], "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 } ```