> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update

> Update an Edge's hosting, egress policy, required checks, credentials, or inference routes via update_mask.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{app_id}/edges/{id}
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/apps/{app_id}/edges/{id}:
    post:
      tags:
        - Edge
      summary: Update
      description: >-
        Update an Edge's hosting, egress policy, required checks, credentials,
        or inference routes via update_mask.
      operationId: c1.api.edge.v1.EdgeService.Update
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: App identifier.
            type: string
        - in: path
          name: id
          required: true
          schema:
            description: The id field.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.edge.v1.EdgeServiceUpdateRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/c1.api.edge.v1.EdgeServiceUpdateResponse'
          description: EdgeServiceUpdateResponse returns the updated Edge.
      x-codeSamples:
        - lang: go
          label: Update
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.Edge.Update(ctx, operations.C1APIEdgeV1EdgeServiceUpdateRequest{\n        AppID: \"<id>\",\n        ID: \"<id>\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.EdgeServiceUpdateResponse != nil {\n        // handle response\n    }\n}"
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.edge.update({
                appId: "<id>",
                id: "<id>",
              });

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.edge.v1.EdgeServiceUpdateRequestInput:
      description: >-
        EdgeServiceUpdateRequest updates an existing Edge via update_mask.
        Editable
         paths: mode, enabled_kinds, egress_rules, egress_unmatched_rule, egress_checks,
         credential_injections, inference_routes, inference_connections, allow_inference_bearer_tokens,
         egress_tls, response_inspection_profile.
         The legacy inference mask may clear or replace one graph.
      properties:
        edge:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.Edge'
            - type: 'null'
        updateMask:
          type:
            - string
            - 'null'
      title: Edge Service Update Request
      type: object
      x-speakeasy-name-override: EdgeServiceUpdateRequest
    c1.api.edge.v1.EdgeServiceUpdateResponse:
      description: EdgeServiceUpdateResponse returns the updated Edge.
      properties:
        edge:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.Edge'
            - type: 'null'
      title: Edge Service Update Response
      type: object
      x-speakeasy-name-override: EdgeServiceUpdateResponse
    c1.api.edge.v1.Edge:
      description: >-
        Edge is an application-owned configuration for egress and inference
        services.
      properties:
        allowInferenceBearerTokens:
          description: >-
            Opt in to short-lived inference Bearer credentials; false by
            default.
             Enforcement requires a runtime that consumes this setting.
          type: boolean
        appId:
          description: App identifier.
          type: string
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        credentialInjections:
          description: >-
            Vault-backed headers the hosted Edge adds to matching egress
            requests.
             Grant the vault's OpenSecret entitlement to the Edge's service principal.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeCredentialInjection'
          type:
            - array
            - 'null'
        displayName:
          description: The displayName field.
          type: string
        egressChecks:
          description: >-
            Required artifact authorizers, independent of ordinary egress access
            rules.
             Disabled checks retain their integration references.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressCheck'
          type:
            - array
            - 'null'
        egressConnectEntitlementId:
          description: >-
            The minted egress.connect entitlement (derived from the Edge id) --
            grant
             it to a caller to let it open an authenticated egress connection. Empty
             when egress is not in enabled_kinds.
          type: string
        egressRules:
          description: >-
            Ordered egress access rules, evaluated first-match-wins. If none
            decide,
             egress_unmatched_rule applies (deny when absent). Order is significant.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressRule'
          type:
            - array
            - 'null'
        egressRulesConfigured:
          description: >-
            Whether the egress policy has been deliberately configured. Setting
            either
             egress_rules or egress_unmatched_rule configures it, even with no ordered
             rules. False with neither means destinations are not restricted by rules.
          type: boolean
        egressTls:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeTlsSelection'
            - type: 'null'
        egressUnmatchedRule:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressRule'
            - type: 'null'
        enabledKinds:
          description: >-
            The capabilities this Edge currently serves. A request naming a
            resource
             for a capability outside this set is denied, independent of mode. At
             least one kind is required.
          items:
            enum:
              - EDGE_CAPABILITY_KIND_UNSPECIFIED
              - EDGE_CAPABILITY_KIND_EGRESS
              - EDGE_CAPABILITY_KIND_INFERENCE
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
        id:
          description: The id field.
          type: string
        inference:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceRoute'
            - type: 'null'
        inferenceConnections:
          description: >-
            Provider connections saved with or without routes, at most one per
            catalog entry. update_mask
             "inference_connections" replaces the set. The Edge runtime uses them only to list a provider's
             models; they never serve inference. The Edge runtime service principal must hold each Vault's
             OpenSecret grant.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceConnection'
          type:
            - array
            - 'null'
        inferenceInvokeEntitlementId:
          description: >-
            The minted inference.invoke entitlement (derived from the Edge id).
            Empty
             when inference is not in enabled_kinds.
          type: string
        inferenceModelsReadEntitlementId:
          description: >-
            The minted inference.models.read entitlement (derived from the Edge
            id).
             Empty when inference is not in enabled_kinds.
          type: string
        inferenceRoutes:
          description: >-
            Complete ordered set of inference routes; route IDs are unique
            within this
             Edge, and other Edges may publish the same ID. update_mask
             "inference_routes" atomically replaces the entire set (including empty).
             Up to 40 routes per Edge; replacing a set is atomic.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceRoute'
          type:
            - array
            - 'null'
        mode:
          description: >-
            Hosting state for the service configuration. DISABLED and
            UNSPECIFIED
             deny every request. ENFORCE and OBSERVE both still require capability
             authorization; content policy and routing remain configured on the Edge
             host. OBSERVE is currently identical to ENFORCE -- it exists so an
             operator can stage an Edge ahead of destination-level policy support,
             which does not exist yet.
          enum:
            - EDGE_MODE_UNSPECIFIED
            - EDGE_MODE_DISABLED
            - EDGE_MODE_OBSERVE
            - EDGE_MODE_ENFORCE
          type: string
          x-speakeasy-unknown-values: allow
        responseInspectionProfile:
          description: >-
            Default inspection profile for hosted egress response bodies.
            Unspecified
             means strict. Requests always use strict inspection. Web balanced requires
             a runtime that supports it; older runtimes retain strict inspection.
          enum:
            - EDGE_RESPONSE_INSPECTION_PROFILE_UNSPECIFIED
            - EDGE_RESPONSE_INSPECTION_PROFILE_STRICT
            - EDGE_RESPONSE_INSPECTION_PROFILE_WEB_BALANCED
          type: string
          x-speakeasy-unknown-values: allow
        tokenAudience:
          description: >-
            The `audience` to send when exchanging a token for access to this
            Edge.
             Every Edge deployment in the tenant shares it, so it names the service;
             `token_resources` identify its service endpoints.
          type: string
        tokenResources:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeTokenResources'
            - type: 'null'
        tokenScopes:
          description: >-
            The scopes this Edge can issue. Explicit requests fail if any scope
            is
             ungranted; an omitted scope requests the granted capabilities of each resource.
          items:
            type: string
          type:
            - array
            - 'null'
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
      title: Edge
      type: object
      x-speakeasy-name-override: Edge
    c1.api.edge.v1.EdgeCredentialInjection:
      description: EdgeCredentialInjection binds one C1 vault secret to one request header.
      properties:
        contentType:
          description: The secret's stored content type. Defaults to "api_key".
          type: string
        headerName:
          description: Header to set, replacing any value supplied by the caller.
          type: string
        hostPattern:
          description: Destination host glob, e.g. "api.example.com" or "*.example.com".
          type: string
        pathPattern:
          description: Request path glob, e.g. "/v1/*". Empty matches every path.
          type: string
        secretId:
          description: Secret to inject.
          type: string
        valuePrefix:
          description: Literal text placed before the secret value, e.g. "Bearer ".
          type: string
        vaultId:
          description: Vault holding the secret.
          type: string
      title: Edge Credential Injection
      type: object
      x-speakeasy-name-override: EdgeCredentialInjection
    c1.api.edge.v1.EdgeEgressCheck:
      description: >
        EdgeEgressCheck requires an integration's authorization in addition to
        egress policy.


        This message contains a oneof named authorizer. Only a single field of
        the following list may be set at a time:
          - integration
      properties:
        enabled:
          description: >-
            Whether this check is enforced. Disabled checks still reference the
            integration.
          type: boolean
        id:
          description: Stable identifier unique within the Edge.
          type: string
        integration:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeIntegrationRef'
            - type: 'null'
        match:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressRequestMatch'
            - type: 'null'
      title: Edge Egress Check
      type: object
      x-speakeasy-name-override: EdgeEgressCheck
    c1.api.edge.v1.EdgeEgressRule:
      description: >
        The EdgeEgressRule message.


        This message contains a oneof named pdp. Only a single field of the
        following list may be set at a time:
          - authzen
      properties:
        allowEmptyEncodedBody:
          description: >-
            When true, a response or request whose declared Content-Encoding is
            a supported
             token (gzip, x-gzip, deflate, br, zstd) but whose body is empty or decodes to zero
             bytes is treated as an empty plaintext instead of failing closed. Off by default.
             Only meaningful on ALLOW rules.
          type: boolean
        allowResponseDecodeRefusals:
          description: >-
            When true, a decode refusal raised while recursively decoding
            content nested inside a
             RESPONSE body (e.g. a gzip-looking byte run in a binary download that fails to inflate,
             an embedded encoding past the depth/size bounds) is recorded but does not by itself
             block the response. Confirmed findings (credentials, keys, PANs) still apply. Off by
             default. Only meaningful on ALLOW rules.
          type: boolean
        authzen:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.AuthzenRef'
            - type: 'null'
        effect:
          description: The effect field.
          enum:
            - EDGE_EGRESS_EFFECT_UNSPECIFIED
            - EDGE_EGRESS_EFFECT_ALLOW
            - EDGE_EGRESS_EFFECT_DENY
            - EDGE_EGRESS_EFFECT_AUTHZEN
          type: string
          x-speakeasy-unknown-values: allow
        endpointPattern:
          description: |-
            Destination host to match: exact hostname, or a single leading "*."
             wildcard for subdomains (e.g. "*.example.com"). Port and path are out of
             scope for v1.
          type: string
        exemptCredentialKinds:
          description: >-
            Content-inspection finding classes this rule exempts from blocking
            on
             the *request* path, since the destination is already trusted for this
             principal. Never applies to response content; see
             exempt_response_credential_kinds for that, deliberately independent.
          items:
            enum:
              - CREDENTIAL_KIND_UNSPECIFIED
              - CREDENTIAL_KIND_JWT
              - CREDENTIAL_KIND_API_KEY
              - CREDENTIAL_KIND_PRIVATE_KEY
              - CREDENTIAL_KIND_VENDOR_CREDENTIAL
              - CREDENTIAL_KIND_PAN
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
        exemptResponseCredentialKinds:
          description: >-
            Content-inspection finding classes this rule exempts from blocking
            on
             the *response* path -- e.g. a destination's own credential-issuance
             reply (temporary cloud credentials, a continuation token) that the
             caller's own service legitimately needs to consume. Deliberately a
             separate list from exempt_credential_kinds, defaulting empty: trusting a
             destination's outbound credential never implies trusting whatever it
             sends back, and an admin must opt a kind into this list explicitly.
          items:
            enum:
              - CREDENTIAL_KIND_UNSPECIFIED
              - CREDENTIAL_KIND_JWT
              - CREDENTIAL_KIND_API_KEY
              - CREDENTIAL_KIND_PRIVATE_KEY
              - CREDENTIAL_KIND_VENDOR_CREDENTIAL
              - CREDENTIAL_KIND_PAN
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
        maxInspectedBodyBytes:
          description: |-
            Overrides, for destinations matching this rule, the largest body (in
             bytes) Time Bandit buffers for content inspection. 0 means unset: Time
             Bandit uses its fleet default (1 MiB). A body above the limit is still
             refused (fail closed) and is never forwarded uninspected. Only meaningful
             on ALLOW rules. Applies whether or not skip_content_inspection is set.
          format: uint64
          type: string
        principal:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressPrincipal'
            - type: 'null'
        request:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeEgressRequestMatch'
            - type: 'null'
        responseInspectionProfile:
          description: |-
            Response-body inspection override, only applied to ALLOW rules.
             Unspecified inherits the Edge's profile; DENY and AUTHZEN clear this field.
             Requests always use strict inspection.
          enum:
            - EDGE_RESPONSE_INSPECTION_PROFILE_UNSPECIFIED
            - EDGE_RESPONSE_INSPECTION_PROFILE_STRICT
            - EDGE_RESPONSE_INSPECTION_PROFILE_WEB_BALANCED
          type: string
          x-speakeasy-unknown-values: allow
        skipContentInspection:
          description: >-
            When true, decoding is optional for destinations matching this rule;
            inspection
             is not. Despite the name, this does NOT skip content inspection: every detector,
             guardrail and header scan still runs and any finding still denies. It only
             changes what happens when a body declares a Content-Encoding that Time Bandit
             has no decoder for. Without the flag the body is denied (fail closed); with it,
             the bytes are scanned as-is through the normal cascade. Trade-off: a secret
             inside genuine compression labelled with an unsupported token is not caught
             (plaintext and gzip still are). A supported encoding that is malformed or
             truncated, decoded output over the inspection cap, and bodies over the wire cap
             still fail closed. Off by default. Only meaningful on ALLOW rules.
          type: boolean
      title: Edge Egress Rule
      type: object
      x-speakeasy-name-override: EdgeEgressRule
    c1.api.edge.v1.EdgeTlsSelection:
      description: >
        EdgeTlsSelection chooses the TLS interception material for an Edge's
         egress proxy.

        This message contains a oneof named selection. Only a single field of
        the following list may be set at a time:
          - builtin
      properties:
        builtin:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeBuiltinTlsConfig'
            - type: 'null'
      title: Edge Tls Selection
      type: object
      x-speakeasy-name-override: EdgeTlsSelection
    c1.api.edge.v1.EdgeInferenceRoute:
      description: >-
        EdgeInferenceRoute declares a caller-visible model selector and a
        bounded
         provider graph. Legacy scalar fields decode previously stored singletons;
         new configurations use native_format, targets, and selection.
      properties:
        allowHumanCallers:
          description: >-
            Explicitly authorize enabled human users holding per-capability app
            grants
             to exchange an SSO id_token with DPoP. False preserves workload-only routes.
          type: boolean
        callerServicePrincipalId:
          description: >-
            Required in workload mode; forbidden when allow_human_callers is
            true.
             Workload callers must hold both inference capability grants.
          type: string
        callerWorkloadFederationTrustId:
          description: >-
            The workload caller's exact federation trust; forbidden in human
            mode.
          type: string
        contentType:
          description: The contentType field.
          type: string
        expectedSecretVersion:
          deprecated: true
          description: >-
            Deprecated setup-time pin. New writes must leave it empty; the
            runtime
             resolves the active version of each target's Vault secret.
          type: string
        followedTier:
          description: >-
            C1 tier this route follows; UNSPECIFIED means it follows no tier. On
            write, a route that sets a tier must
             use the route_id c1-<tier>; the server replaces its targets and selection with the tier's current model,
             served through the providers this Edge already has credentials for, and also publishes that model's name
             as a second route. Clearing the tier (and publication) on a published route pins it to its current
             targets.
          enum:
            - EDGE_INFERENCE_TIER_UNSPECIFIED
            - EDGE_INFERENCE_TIER_FAST
            - EDGE_INFERENCE_TIER_BALANCED
            - EDGE_INFERENCE_TIER_BEST
          type: string
          x-speakeasy-unknown-values: allow
        nativeFormat:
          description: >-
            Accepted native client request format; never inferred from caller
            headers.
          enum:
            - EDGE_INFERENCE_NATIVE_FORMAT_UNSPECIFIED
            - EDGE_INFERENCE_NATIVE_FORMAT_OPENAI_RESPONSES
            - EDGE_INFERENCE_NATIVE_FORMAT_OPENAI_CHAT
            - EDGE_INFERENCE_NATIVE_FORMAT_ANTHROPIC_MESSAGES
          type: string
          x-speakeasy-unknown-values: allow
        publication:
          description: >-
            Which C1-published route of a followed tier this is. Set by the
            server; send back the value you read.
             UNSPECIFIED for a tenant-authored route.
          enum:
            - EDGE_INFERENCE_ROUTE_PUBLICATION_UNSPECIFIED
            - EDGE_INFERENCE_ROUTE_PUBLICATION_TIER
            - EDGE_INFERENCE_ROUTE_PUBLICATION_MODEL_ALIAS
          type: string
          x-speakeasy-unknown-values: allow
        registryModelId:
          description: Registry model the route was built from; empty for a custom model.
          type: string
        routeId:
          description: >-
            Tenant-owned route identifier, unique within its Edge; other Edges
            may
             publish the same ID. ListInferenceRoutes reports routes already configured
             for this application, not an allowlist.
          type: string
        secretId:
          description: The secretId field.
          type: string
        selection:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceSelection'
            - type: 'null'
        targets:
          description: >-
            Explicit upstream targets; no request may choose a target or
            destination.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceTarget'
          type:
            - array
            - 'null'
        upstreamModelId:
          description: Legacy singleton model, empty for graph routes.
          type: string
        vaultBoundaryId:
          description: Legacy singleton Vault reference, empty for graph routes.
          type: string
      title: Edge Inference Route
      type: object
      x-speakeasy-name-override: EdgeInferenceRoute
    c1.api.edge.v1.EdgeInferenceConnection:
      description: >-
        EdgeInferenceConnection is a Vault-backed credential for one inference
        catalog provider.
      properties:
        catalogEntryId:
          description: Catalog entry, e.g. anthropic. Unique within the Edge.
          type: string
        region:
          description: The region field.
          type: string
        secretId:
          description: The secretId field.
          type: string
        variantId:
          description: >-
            Catalog variant of the entry; it sets the provider profile and
            destination.
          type: string
        vaultBoundaryId:
          description: The vaultBoundaryId field.
          type: string
      title: Edge Inference Connection
      type: object
      x-speakeasy-name-override: EdgeInferenceConnection
    c1.api.edge.v1.EdgeTokenResources:
      description: >-
        EdgeTokenResources names the resource URI for each supported Edge
        service.
         A field is empty when its capability is not in enabled_kinds.
      properties:
        egress:
          description: Resource URI used with the egress.connect scope.
          type: string
        inference:
          description: >-
            Resource URI used with the inference.models.read / inference.invoke
            scopes.
          type: string
      title: Edge Token Resources
      type: object
      x-speakeasy-name-override: EdgeTokenResources
    c1.api.edge.v1.EdgeIntegrationRef:
      description: EdgeIntegrationRef names an integration in the Edge's own application.
      properties:
        integrationId:
          description: Identifier of the integration.
          type: string
      title: Edge Integration Ref
      type: object
      x-speakeasy-name-override: EdgeIntegrationRef
    c1.api.edge.v1.EdgeEgressRequestMatch:
      description: |-
        EdgeEgressRule is one ordered row of an Edge's egress access policy.
         EdgeEgressRequestMatch selects requests by method, path, query and headers. Every set
         selector must match (AND); an unset selector does not constrain. Within a selector,
         methods match any listed value. Each query or header key constrained by a value glob
         must occur exactly once in the request, or the request is denied.
      properties:
        headerEquals:
          additionalProperties:
            type: string
          description: >-
            Header name to '*' value glob, matched case-sensitively after OWS
            trim. Each header
             must occur exactly once. Names are case-insensitive and must be unique after folding.
          type: object
        headerPresent:
          description: >-
            Header names that must be present (any value). Names are
            case-insensitive.
          items:
            type: string
          type:
            - array
            - 'null'
        methods:
          description: Methods (any of). Upper-case tokens. Empty means any method.
          items:
            type: string
          type:
            - array
            - 'null'
        packageArtifact:
          description: >-
            Artifact classification selector. Only required checks may set this
            field;
             ordinary egress rules reject its presence, including an explicit false.
          type:
            - boolean
            - 'null'
        path:
          description: >-
            Path segment-glob over the canonical path. `*` matches one segment
            and `**` one or more.
             Empty means any path.
          type: string
        queryEquals:
          additionalProperties:
            type: string
          description: >-
            Query key to case-sensitive '*' value glob. Each key must occur
            exactly once.
          type: object
        queryPresent:
          description: Query keys that must be present (any value). Case-sensitive.
          items:
            type: string
          type:
            - array
            - 'null'
      title: Edge Egress Request Match
      type: object
      x-speakeasy-name-override: EdgeEgressRequestMatch
    c1.api.edge.v1.AuthzenRef:
      description: >-
        AuthzenRef names an AuthzenServer. An empty app_id means the Edge's own
        app
         for rules saved before cross-app references were supported.
      properties:
        appId:
          description: App that owns the AuthzenServer. Empty resolves to the Edge's app.
          type: string
        serverId:
          description: >-
            ID of the AuthzenServer. It must exist in the target app and be in
            OBSERVE
             or ENFORCE mode.
          type: string
      title: Authzen Ref
      type: object
      x-speakeasy-name-override: AuthzenRef
    c1.api.edge.v1.EdgeEgressPrincipal:
      description: >
        EdgeEgressPrincipal is the caller a rule matches against. Exactly one
        arm
         must be set.

        This message contains a oneof named scope. Only a single field of the
        following list may be set at a time:
          - all
          - userId
          - entitlementId
      properties:
        all:
          description: >-
            The all field.

            This field is part of the `scope` oneof.

            See the documentation for `c1.api.edge.v1.EdgeEgressPrincipal` for
            more details.
          type:
            - boolean
            - 'null'
        entitlementId:
          description: >-
            An App Entitlement belonging to the same App the Edge belongs to.

            This field is part of the `scope` oneof.

            See the documentation for `c1.api.edge.v1.EdgeEgressPrincipal` for
            more details.
          type:
            - string
            - 'null'
        userId:
          description: >-
            The userId field.

            This field is part of the `scope` oneof.

            See the documentation for `c1.api.edge.v1.EdgeEgressPrincipal` for
            more details.
          type:
            - string
            - 'null'
      title: Edge Egress Principal
      type: object
      x-speakeasy-name-override: EdgeEgressPrincipal
    c1.api.edge.v1.EdgeBuiltinTlsConfig:
      description: |-
        EdgeBuiltinTlsConfig selects TLS interception material managed by
         ConductorOne.
      properties:
        kind:
          description: |-
            The kind of managed material. Only EDGE_BUILTIN_TLS_KIND_EDGE_CA is
             supported.
          enum:
            - EDGE_BUILTIN_TLS_KIND_UNSPECIFIED
            - EDGE_BUILTIN_TLS_KIND_EDGE_CA
          type: string
          x-speakeasy-unknown-values: allow
      title: Edge Builtin Tls Config
      type: object
      x-speakeasy-name-override: EdgeBuiltinTlsConfig
    c1.api.edge.v1.EdgeInferenceSelection:
      description: The EdgeInferenceSelection message.
      properties:
        attemptTimeoutMs:
          description: The attemptTimeoutMs field.
          format: uint32
          type: integer
        confidenceThreshold:
          description: The confidenceThreshold field.
          type: number
        handoffNotes:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceHandoffNotes'
            - type: 'null'
        maxAttempts:
          description: The maxAttempts field.
          format: uint32
          type: integer
        pickerMode:
          description: The pickerMode field.
          enum:
            - EDGE_INFERENCE_STAGE_PICKER_MODE_UNSPECIFIED
            - EDGE_INFERENCE_STAGE_PICKER_MODE_EFFICIENT_FIRST
            - EDGE_INFERENCE_STAGE_PICKER_MODE_CAPABLE_FIRST
          type: string
          x-speakeasy-unknown-values: allow
        recentWindow:
          description: The recentWindow field.
          format: uint32
          type: integer
        retry:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceRetry'
            - type: 'null'
        routeDeadlineMs:
          description: The routeDeadlineMs field.
          format: uint32
          type: integer
        stages:
          description: The stages field.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceStage'
          type:
            - array
            - 'null'
        strategy:
          description: The strategy field.
          enum:
            - EDGE_INFERENCE_SELECTION_STRATEGY_UNSPECIFIED
            - EDGE_INFERENCE_SELECTION_STRATEGY_SINGLE
            - EDGE_INFERENCE_SELECTION_STRATEGY_FAILOVER
            - EDGE_INFERENCE_SELECTION_STRATEGY_STAGE_ROUTER
          type: string
          x-speakeasy-unknown-values: allow
        targetIds:
          description: The targetIds field.
          items:
            type: string
          type:
            - array
            - 'null'
      title: Edge Inference Selection
      type: object
      x-speakeasy-name-override: EdgeInferenceSelection
    c1.api.edge.v1.EdgeInferenceTarget:
      description: The EdgeInferenceTarget message.
      properties:
        catalogEntryId:
          description: >-
            Catalog entry and variant to expand on write. Set both with
            target_id, upstream_model_id, region (AWS variants) and the
             secret reference; the server fills the provider profile, destination, credential source and recipe, content type,
             upstream path and model id grammar from the variant. Other provider fields must be unset or match the variant.
          type: string
        catalogVariantId:
          description: The catalogVariantId field.
          type: string
        circuitBreaker:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceCircuitBreaker'
            - type: 'null'
        contentType:
          description: The contentType field.
          type: string
        contextLength:
          description: The contextLength field.
          format: uint32
          type: integer
        credentialFailurePolicy:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.edge.v1.EdgeInferenceCredentialFailurePolicy
            - type: 'null'
        credentialRecipe:
          description: The credentialRecipe field.
          type: string
        credentialSource:
          description: The credentialSource field.
          enum:
            - EDGE_INFERENCE_CREDENTIAL_SOURCE_UNSPECIFIED
            - EDGE_INFERENCE_CREDENTIAL_SOURCE_TENANT_VAULT
            - EDGE_INFERENCE_CREDENTIAL_SOURCE_AWS_WORKLOAD_IDENTITY
          type: string
          x-speakeasy-unknown-values: allow
        destination:
          description: Empty only when a catalog variant expands it.
          type: string
        expectedSecretVersion:
          description: >-
            Output-only: resolved active version in the distributed
            configuration.
          type: string
        modelIdGrammar:
          description: The modelIdGrammar field.
          type: string
        providerProfile:
          description: >-
            Empty only when catalog_entry_id and catalog_variant_id expand it;
            the expanded target is validated in full.
          type: string
        reasoningEffort:
          description: The reasoningEffort field.
          type: string
        region:
          description: The region field.
          type: string
        secretId:
          description: The secretId field.
          type: string
        targetId:
          description: The targetId field.
          type: string
        upstreamModelId:
          description: >-
            Empty only for credential-source targets on a route following a C1
            tier; tier publication supplies
             the model and validates the expanded target in full. Ordinary targets must supply a model.
          type: string
        upstreamPath:
          description: The upstreamPath field.
          type: string
        vaultBoundaryId:
          description: The vaultBoundaryId field.
          type: string
      title: Edge Inference Target
      type: object
      x-speakeasy-name-override: EdgeInferenceTarget
    c1.api.edge.v1.EdgeInferenceHandoffNotes:
      description: The EdgeInferenceHandoffNotes message.
      properties:
        deescalationNote:
          description: The deescalationNote field.
          type: string
        escalationNote:
          description: The escalationNote field.
          type: string
        onlyOnWrongSignalEscalation:
          description: The onlyOnWrongSignalEscalation field.
          type: boolean
      title: Edge Inference Handoff Notes
      type: object
      x-speakeasy-name-override: EdgeInferenceHandoffNotes
    c1.api.edge.v1.EdgeInferenceRetry:
      description: |-
        Bounds the delay between provider attempts on one route. Only transient
         provider failures (rate limit, provider timeout, overload, a pre-response
         transport failure, a generic upstream error) ever wait; credential, policy,
         configuration and other 4xx rejections stay terminal.
      properties:
        baseMs:
          description: >-
            First backoff ceiling in milliseconds; doubles per consecutive
            transient
             failure in one provider traversal, up to the cap. Zero disables backoff.
          format: uint32
          type: integer
        capMs:
          description: >-
            Largest delay in milliseconds, including a clamped provider
            Retry-After.
          format: uint32
          type: integer
        jitter:
          description: >-
            Draw each delay uniformly from zero to the ceiling instead of
            waiting the
             ceiling exactly.
          type: boolean
        maxSameTargetRetries:
          description: >-
            Extra attempts against the same target after a transient failure,
            before
             failing over. Each one spends one of the route's attempts.
          format: uint32
          type: integer
      title: Edge Inference Retry
      type: object
      x-speakeasy-name-override: EdgeInferenceRetry
    c1.api.edge.v1.EdgeInferenceStage:
      description: The EdgeInferenceStage message.
      properties:
        judge:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceJudge'
            - type: 'null'
        judgeTargetId:
          description: The judgeTargetId field.
          type: string
        stageId:
          description: The stageId field.
          type: string
        targetIds:
          description: The targetIds field.
          items:
            type: string
          type:
            - array
            - 'null'
        tierPrompt:
          description: The tierPrompt field.
          type: string
      title: Edge Inference Stage
      type: object
      x-speakeasy-name-override: EdgeInferenceStage
    c1.api.edge.v1.EdgeInferenceCircuitBreaker:
      description: The EdgeInferenceCircuitBreaker message.
      properties:
        cooldownMs:
          description: The cooldownMs field.
          format: uint32
          type: integer
        failureThreshold:
          description: The failureThreshold field.
          format: uint32
          type: integer
      title: Edge Inference Circuit Breaker
      type: object
      x-speakeasy-name-override: EdgeInferenceCircuitBreaker
    c1.api.edge.v1.EdgeInferenceCredentialFailurePolicy:
      description: The EdgeInferenceCredentialFailurePolicy message.
      properties:
        notApplicable:
          description: The notApplicable field.
          enum:
            - EDGE_INFERENCE_FAILURE_DISPOSITION_UNSPECIFIED
            - EDGE_INFERENCE_FAILURE_DISPOSITION_STOP
            - EDGE_INFERENCE_FAILURE_DISPOSITION_NEXT_TARGET
          type: string
          x-speakeasy-unknown-values: allow
        rejected401:
          description: The rejected401 field.
          enum:
            - EDGE_INFERENCE_FAILURE_DISPOSITION_UNSPECIFIED
            - EDGE_INFERENCE_FAILURE_DISPOSITION_STOP
            - EDGE_INFERENCE_FAILURE_DISPOSITION_NEXT_TARGET
          type: string
          x-speakeasy-unknown-values: allow
        unavailableOrExpired:
          description: The unavailableOrExpired field.
          enum:
            - EDGE_INFERENCE_FAILURE_DISPOSITION_UNSPECIFIED
            - EDGE_INFERENCE_FAILURE_DISPOSITION_STOP
            - EDGE_INFERENCE_FAILURE_DISPOSITION_NEXT_TARGET
          type: string
          x-speakeasy-unknown-values: allow
      title: Edge Inference Credential Failure Policy
      type: object
      x-speakeasy-name-override: EdgeInferenceCredentialFailurePolicy
    c1.api.edge.v1.EdgeInferenceJudge:
      description: The EdgeInferenceJudge message.
      properties:
        baseThreshold:
          description: The baseThreshold field.
          type: number
        decision:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeInferenceDecisionJudge'
            - type: 'null'
        failOpen:
          description: >-
            Whether a judge failure serves the stage result unjudged. Unset
            means true.
          type:
            - boolean
            - 'null'
        maxOutputTokens:
          description: >-
            Maximum tokens available to classify a stage result (1 to 16,384).
            Required for an LLM judge; must be unset
             when decision is set.
          format: uint32
          type: integer
        prompt:
          description: The prompt field.
          type: string
        recentTurnWindow:
          description: The recentTurnWindow field.
          format: uint32
          type: integer
        thresholdStep:
          description: The thresholdStep field.
          type: number
      title: Edge Inference Judge
      type: object
      x-speakeasy-name-override: EdgeInferenceJudge
    c1.api.edge.v1.EdgeInferenceDecisionJudge:
      description: >-
        EdgeInferenceDecisionJudge configures a decision-model judge choosing
        between the stage's efficient and capable
         tiers.
      properties:
        capableLabel:
          description: Label of the capable candidate.
          type: string
        cutoff:
          description: >-
            Cutoff in [0, 1]. The judge selects the capable label only when its
            score is strictly above the cutoff; a score
             equal to the cutoff stays on the efficient tier.
          type: number
        efficientLabel:
          description: Label of the efficient candidate. Must differ from capable_label.
          type: string
        evidenceJson:
          description: >-
            Evidence the decision model scores, as a JSON document of at most
            16,384 bytes.
          type: string
        instructionsJson:
          description: >-
            Optional instructions for the decision model, as a JSON document of
            at most 16,384 bytes.
          type:
            - string
            - 'null'
      title: Edge Inference Decision Judge
      type: object
      x-speakeasy-name-override: EdgeInferenceDecisionJudge
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````