## Add one operation to a zone

`client.APIGateway.Operations.New(ctx, params) (*OperationNewResponse, error)`

**post** `/zones/{zone_id}/api_gateway/operations/item`

Add one operation to a zone. Endpoints can contain path variables. Host, method, endpoint will be normalized to a canoncial form when creating an operation and must be unique on the zone. Inserting an operation that matches an existing one will return the record of the already existing operation and update its last_updated date.

### Parameters

- `params OperationNewParams`

  - `ZoneID param.Field[string]`

    Path param: Identifier.

  - `Endpoint param.Field[string]`

    Body param: 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/.

  - `Host param.Field[string]`

    Body param: RFC3986-compliant host.

  - `Method param.Field[OperationNewParamsMethod]`

    Body param: The HTTP method used to access the endpoint.

    - `const OperationNewParamsMethodGet OperationNewParamsMethod = "GET"`

    - `const OperationNewParamsMethodPost OperationNewParamsMethod = "POST"`

    - `const OperationNewParamsMethodHead OperationNewParamsMethod = "HEAD"`

    - `const OperationNewParamsMethodOptions OperationNewParamsMethod = "OPTIONS"`

    - `const OperationNewParamsMethodPut OperationNewParamsMethod = "PUT"`

    - `const OperationNewParamsMethodDelete OperationNewParamsMethod = "DELETE"`

    - `const OperationNewParamsMethodConnect OperationNewParamsMethod = "CONNECT"`

    - `const OperationNewParamsMethodPatch OperationNewParamsMethod = "PATCH"`

    - `const OperationNewParamsMethodTrace OperationNewParamsMethod = "TRACE"`

### Returns

- `type OperationNewResponse 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/.

  - `Host string`

    RFC3986-compliant host.

  - `LastUpdated Time`

  - `Method OperationNewResponseMethod`

    The HTTP method used to access the endpoint.

    - `const OperationNewResponseMethodGet OperationNewResponseMethod = "GET"`

    - `const OperationNewResponseMethodPost OperationNewResponseMethod = "POST"`

    - `const OperationNewResponseMethodHead OperationNewResponseMethod = "HEAD"`

    - `const OperationNewResponseMethodOptions OperationNewResponseMethod = "OPTIONS"`

    - `const OperationNewResponseMethodPut OperationNewResponseMethod = "PUT"`

    - `const OperationNewResponseMethodDelete OperationNewResponseMethod = "DELETE"`

    - `const OperationNewResponseMethodConnect OperationNewResponseMethod = "CONNECT"`

    - `const OperationNewResponseMethodPatch OperationNewResponseMethod = "PATCH"`

    - `const OperationNewResponseMethodTrace OperationNewResponseMethod = "TRACE"`

  - `OperationID string`

    UUID.

  - `Features OperationNewResponseFeatures`

    - `type OperationNewResponseFeaturesAPIShieldOperationFeatureThresholds struct{…}`

      - `Thresholds OperationNewResponseFeaturesAPIShieldOperationFeatureThresholdsThresholds`

        - `AuthIDTokens int64`

          The total number of auth-ids seen across this calculation.

        - `DataPoints int64`

          The number of data points used for the threshold suggestion calculation.

        - `LastUpdated Time`

        - `P50 int64`

          The p50 quantile of requests (in period_seconds).

        - `P90 int64`

          The p90 quantile of requests (in period_seconds).

        - `P99 int64`

          The p99 quantile of requests (in period_seconds).

        - `PeriodSeconds int64`

          The period over which this threshold is suggested.

        - `Requests int64`

          The estimated number of requests covered by these calculations.

        - `SuggestedThreshold int64`

          The suggested threshold in requests done by the same auth_id or period_seconds.

    - `type OperationNewResponseFeaturesAPIShieldOperationFeatureParameterSchemas struct{…}`

      - `ParameterSchemas OperationNewResponseFeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemas`

        - `LastUpdated Time`

        - `ParameterSchemas OperationNewResponseFeaturesAPIShieldOperationFeatureParameterSchemasParameterSchemasParameterSchemas`

          An operation schema object containing a response.

          - `Parameters []unknown`

            An array containing the learned parameter schemas.

          - `Responses unknown`

            An empty response object. This field is required to yield a valid operation schema.

    - `type OperationNewResponseFeaturesAPIShieldOperationFeatureAPIRouting struct{…}`

      - `APIRouting OperationNewResponseFeaturesAPIShieldOperationFeatureAPIRoutingAPIRouting`

        API Routing settings on endpoint.

        - `LastUpdated Time`

        - `Route string`

          Target route.

    - `type OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervals struct{…}`

      - `ConfidenceIntervals OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervals`

        - `LastUpdated Time`

        - `SuggestedThreshold OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThreshold`

          - `ConfidenceIntervals OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervals`

            - `P90 OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP90`

              Upper and lower bound for percentile estimate

              - `Lower float64`

                Lower bound for percentile estimate

              - `Upper float64`

                Upper bound for percentile estimate

            - `P95 OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP95`

              Upper and lower bound for percentile estimate

              - `Lower float64`

                Lower bound for percentile estimate

              - `Upper float64`

                Upper bound for percentile estimate

            - `P99 OperationNewResponseFeaturesAPIShieldOperationFeatureConfidenceIntervalsConfidenceIntervalsSuggestedThresholdConfidenceIntervalsP99`

              Upper and lower bound for percentile estimate

              - `Lower float64`

                Lower bound for percentile estimate

              - `Upper float64`

                Upper bound for percentile estimate

          - `Mean float64`

            Suggested threshold.

    - `type OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfo struct{…}`

      - `SchemaInfo OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfo`

        - `ActiveSchema OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoActiveSchema`

          Schema active on endpoint.

          - `ID string`

            UUID.

          - `CreatedAt Time`

          - `IsLearned bool`

            True if schema is Cloudflare-provided.

          - `Name string`

            Schema file name.

        - `LearnedAvailable bool`

          True if a Cloudflare-provided learned schema is available for this endpoint.

        - `MitigationAction OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction`

          Action taken on requests failing validation.

          - `const OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionNone OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "none"`

          - `const OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionLog OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "log"`

          - `const OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationActionBlock OperationNewResponseFeaturesAPIShieldOperationFeatureSchemaInfoSchemaInfoMitigationAction = "block"`

### Example

```go
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"),
  )
  operation, err := client.APIGateway.Operations.New(context.TODO(), api_gateway.OperationNewParams{
    ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    Endpoint: cloudflare.F("/api/v1/users/{var1}"),
    Host: cloudflare.F("www.example.com"),
    Method: cloudflare.F(api_gateway.OperationNewParamsMethodGet),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", operation.OperationID)
}
```

#### Response

```json
{
  "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": {
      "thresholds": {
        "auth_id_tokens": 0,
        "data_points": 0,
        "last_updated": "2014-01-01T05:20:00.12345Z",
        "p50": 0,
        "p90": 0,
        "p99": 0,
        "period_seconds": 0,
        "requests": 0,
        "suggested_threshold": 0
      }
    }
  },
  "success": true
}
```