> ## 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.

# Create

> Create an Edge integration. This does not create a Vault, secret, or grant.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{integration_app_id}/edge-integrations
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/{integration_app_id}/edge-integrations:
    post:
      tags:
        - Edge
      summary: Create
      description: >-
        Create an Edge integration. This does not create a Vault, secret, or
        grant.
      operationId: c1.api.edge.v1.EdgeIntegrationService.Create
      parameters:
        - in: path
          name: integration_app_id
          required: true
          schema:
            description: Application owning this integration.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.edge.v1.EdgeIntegrationServiceCreateRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.edge.v1.EdgeIntegrationServiceCreateResponse
          description: >-
            EdgeIntegrationServiceCreateResponse contains the created
            integration.
      x-codeSamples:
        - lang: go
          label: Create
          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.EdgeIntegration.Create(ctx, operations.C1APIEdgeV1EdgeIntegrationServiceCreateRequest{\n        IntegrationAppID: \"<id>\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.EdgeIntegrationServiceCreateResponse != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    c1.api.edge.v1.EdgeIntegrationServiceCreateRequestInput:
      description: >-
        EdgeIntegrationServiceCreateRequest creates integration configuration in
        an application.
      properties:
        integration:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeIntegration'
            - type: 'null'
      title: Edge Integration Service Create Request
      type: object
      x-speakeasy-name-override: EdgeIntegrationServiceCreateRequest
    c1.api.edge.v1.EdgeIntegrationServiceCreateResponse:
      description: EdgeIntegrationServiceCreateResponse contains the created integration.
      properties:
        integration:
          oneOf:
            - $ref: '#/components/schemas/c1.api.edge.v1.EdgeIntegration'
            - type: 'null'
      title: Edge Integration Service Create Response
      type: object
      x-speakeasy-name-override: EdgeIntegrationServiceCreateResponse
    c1.api.edge.v1.EdgeIntegration:
      description: >
        EdgeIntegration is reusable application-owned Edge capability
        configuration.
         Its typed configuration and use site determine its role; Socket package
         authorization is the first supported type. It stores only credential
         references and never contains or returns a secret value.
         Creation requires display_name and socket_packages. Updates may omit fields
         not listed in update_mask.

        This message contains a oneof named configuration. Only a single field
        of the following list may be set at a time:
          - socketPackages
      properties:
        appId:
          description: Application owning this integration.
          type: string
        configurationGeneration:
          description: >-
            Changes only when typed configuration or its credential reference
            changes.
          format: uint64
          type: string
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        displayName:
          description: >-
            Human-readable integration name. Required on creation; may be
            omitted
             when updating other fields.
          type: string
        id:
          description: Integration identifier. Assigned on creation.
          type: string
        referenceCount:
          description: >-
            Number of saved checks referencing this integration, including
            disabled checks.
          format: uint64
          type: string
        socketPackages:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.edge.v1.EdgeSocketPackagesIntegration
            - type: 'null'
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
        vaultSecretRef:
          oneOf:
            - $ref: >-
                #/components/schemas/c1.api.edge.v1.EdgeIntegrationVaultSecretRef
            - type: 'null'
      title: Edge Integration
      type: object
      x-speakeasy-name-override: EdgeIntegration
    c1.api.edge.v1.EdgeSocketPackagesIntegration:
      description: >-
        EdgeSocketPackagesIntegration configures Socket package artifact
        authorization.
      properties:
        organization:
          description: Socket organization slug.
          type: string
      title: Edge Socket Packages Integration
      type: object
      x-speakeasy-name-override: EdgeSocketPackagesIntegration
    c1.api.edge.v1.EdgeIntegrationVaultSecretRef:
      description: >-
        EdgeIntegrationVaultSecretRef names an existing modern shared Vault
        credential.
         The integration type determines the content type; Socket requires api_key.
      properties:
        secretId:
          description: Secret identifier within the Vault.
          type: string
        vaultBoundaryId:
          description: Vault containing the secret.
          type: string
      title: Edge Integration Vault Secret Ref
      type: object
      x-speakeasy-name-override: EdgeIntegrationVaultSecretRef
  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

````