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

# Create a workload identity issuer

> Organization credential administrators only. No external namespace-ownership or staff approval is required. New trust resources default disabled.



## OpenAPI

````yaml https://api.onkernel.com/spec.json post /org/workload_identity_issuers
openapi: 3.1.0
info:
  description: Developer tools and cloud infrastructure for AI agents to use web browsers
  title: Kernel API
  version: 0.1.0
servers:
  - description: API Server
    url: https://api.onkernel.com
security:
  - bearerAuth: []
tags:
  - description: Search the web and retrieve content for selected results.
    name: Search
  - description: Create and manage browser sessions.
    name: Browsers
  - description: Control mouse, keyboard, and screen on the browser instance.
    name: Browser Computer Controls
  - description: >-
      Execute Playwright code against the browser instance and manage the
      executors it runs in.
    name: Browser Playwright
  - description: Execute JavaScript in the browser instance's persistent Browser REPL.
    name: Browser REPL
  - description: Discover and invoke native page tools across the browser instance.
    name: Browser WebMCP
  - description: Read, write, and manage files on the browser instance.
    name: Browser Filesystem
  - description: Execute and manage processes on the browser instance.
    name: Browser Processes
  - description: Record and manage browser session video replays.
    name: Browser Replays
  - description: Stream logs from the browser instance.
    name: Browser Logs
  - description: >-
      Stream live telemetry events from a browser session, and manage the
      destinations sessions export them to.
    name: Browser Telemetry
  - description: Create, list, retrieve, and delete browser profiles.
    name: Profiles
  - description: Define tasks that agents work toward and link the browsers they use.
    name: Tasks
  - description: Discover report types and submit typed reports against tasks.
    name: Reports
  - description: Create and manage proxy configurations for routing browser traffic.
    name: Proxies
  - description: Create, list, retrieve, and delete browser extensions.
    name: Extensions
  - description: Create and manage browser pools for acquiring and releasing browsers.
    name: Browser Pools
  - description: Inspect the identity and authorization context for the current request.
    name: Authentication
  - description: >-
      Create and manage auth connections for automated credential capture and
      login.
    name: Managed Auth
  - description: Create and manage credentials for authentication.
    name: Credentials
  - description: Configure external credential providers like 1Password.
    name: Credential Providers
  - description: List applications and versions.
    name: Apps
  - description: Create and manage app deployments and stream deployment events.
    name: Deployments
  - description: Invoke actions and stream or query invocation status and events.
    name: Invocations
  - description: Read and manage organization-level limits.
    name: Organization
  - description: Create and manage projects for resource isolation within an organization.
    name: Projects
  - description: Create and manage API keys for organization and project-scoped access.
    name: API Keys
  - description: Read audit log records for the authenticated organization.
    name: Audit Logs
  - description: Resolve browser and proxy recommendations for bot-protected sites.
    name: Config Registry
paths:
  /org/workload_identity_issuers:
    post:
      tags:
        - Workload Identity
      summary: Create a workload identity issuer
      description: >-
        Organization credential administrators only. No external
        namespace-ownership or staff approval is required. New trust resources
        default disabled.
      operationId: createWorkloadIdentityIssuer
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkloadIdentityIssuerConfig'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkloadIdentityIssuer'
          description: Created
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '500':
          $ref: '#/components/responses/InternalError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - bearerAuth: []
components:
  schemas:
    WorkloadIdentityIssuerConfig:
      additionalProperties: false
      properties:
        description:
          default: ''
          maxLength: 4096
          type: string
        enabled:
          default: false
          type: boolean
        issuer_url:
          description: >-
            Exact expected signed issuer. Optional for github_actions and
            google_cloud, which each have one fixed issuer.
          format: uri
          maxLength: 2048
          type: string
        jwks:
          $ref: '#/components/schemas/WorkloadIdentityKeySource'
        name:
          maxLength: 128
          minLength: 1
          pattern: ^[A-Za-z0-9][A-Za-z0-9-]*$
          type: string
        preset_type:
          $ref: '#/components/schemas/WorkloadIdentityPresetType'
        token_validation:
          $ref: '#/components/schemas/WorkloadIdentityTokenValidation'
      required:
        - name
      type: object
    WorkloadIdentityIssuer:
      additionalProperties: false
      properties:
        archived_at:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        created_at:
          format: date-time
          readOnly: true
          type: string
        created_by_user_id:
          readOnly: true
          type:
            - string
            - 'null'
        description:
          default: ''
          maxLength: 4096
          type: string
        enabled:
          default: false
          type: boolean
        id:
          readOnly: true
          type: string
        issuer_url:
          description: >-
            Exact expected signed issuer. Optional for github_actions and
            google_cloud, which each have one fixed issuer.
          format: uri
          maxLength: 2048
          type: string
        jwks:
          $ref: '#/components/schemas/WorkloadIdentityKeySource'
        name:
          maxLength: 128
          minLength: 1
          pattern: ^[A-Za-z0-9][A-Za-z0-9-]*$
          type: string
        org_id:
          readOnly: true
          type: string
        preset_type:
          $ref: '#/components/schemas/WorkloadIdentityPresetType'
        security_version:
          description: Authority revision. Cosmetic updates do not widen permissions.
          minimum: 1
          readOnly: true
          type: integer
        token_validation:
          $ref: '#/components/schemas/WorkloadIdentityTokenValidation'
        updated_at:
          format: date-time
          readOnly: true
          type: string
      required:
        - name
        - description
        - issuer_url
        - preset_type
        - jwks
        - token_validation
        - enabled
        - id
        - org_id
        - security_version
        - created_by_user_id
        - created_at
        - updated_at
        - archived_at
      type: object
    WorkloadIdentityKeySource:
      additionalProperties: false
      properties:
        ca_cert_pem:
          description: >-
            Optional public CA certificates. When set, only these CAs are
            trusted for key retrieval, in place of the system roots. Private
            keys and private-network retrieval are not supported.
          maxLength: 65536
          type: string
        discovery_base_url:
          format: uri
          maxLength: 2048
          type: string
        keys:
          items:
            additionalProperties: true
            type: object
          maxItems: 16
          minItems: 1
          type: array
        type:
          enum:
            - discovery
            - explicit_url
            - inline
          type: string
        url:
          format: uri
          maxLength: 2048
          type: string
      required:
        - type
      type: object
    WorkloadIdentityPresetType:
      description: >-
        The kind of identity provider. GitHub Actions, Google Cloud and
        Microsoft Entra issuers are recognized by their issuer URL and must use
        their own type. Defaults to the type the issuer URL belongs to, or
        custom_oidc.
      enum:
        - github_actions
        - aws
        - google_cloud
        - microsoft_entra
        - kubernetes
        - custom_oidc
      type: string
    WorkloadIdentityTokenValidation:
      additionalProperties: false
      properties:
        max_lifetime_seconds:
          description: >-
            Maximum incoming signed exp minus iat, independent of outgoing token
            lifetime.
          maximum: 86400
          minimum: 1
          type: integer
        replay_protection:
          description: >-
            Whether an incoming token can be exchanged more than once before it
            expires. Defaults to single_use, except for google_cloud, which is
            always allow_reuse because Google identity tokens carry no token ID.
            allow_reuse is also available for microsoft_entra, kubernetes and
            custom_oidc. github_actions and aws are always single_use.
          enum:
            - single_use
            - allow_reuse
          type: string
      type: object
    Error:
      properties:
        code:
          description: Application-specific error code (machine-readable)
          example: bad_request
          type: string
        details:
          description: Additional error details (for multiple errors)
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
        inner_error:
          $ref: '#/components/schemas/ErrorDetail'
        message:
          description: Human-readable error description for debugging
          example: 'Missing required field: app_name'
          type: string
      required:
        - code
        - message
      type: object
    ErrorDetail:
      properties:
        code:
          description: Lower-level error code providing more specific detail
          example: invalid_input
          type: string
        message:
          description: Further detail about the error
          example: Provided version string is not semver compliant
          type: string
      type: object
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Bad Request – invalid input
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Unauthorized – missing or invalid authorization token
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Forbidden – insufficient permissions or plan
    NotFound:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Resource not found
    Conflict:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Conflict – resource already exists
    InternalError:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Internal Server Error
    ServiceUnavailable:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Service unavailable
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.