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

# Identity Start

> Begin SSO device-code binding for an enrolled-but-unidentified device.

The agent shows ``verification_uri`` (already carrying the code) to the
employee; completing workspace SSO there binds this device to them.



## OpenAPI

````yaml /api-reference/openapi.json post /api/runtime-security/agent/identity/start
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
paths:
  /api/runtime-security/agent/identity/start:
    post:
      tags:
        - runtime-security-agent
      summary: Identity Start
      description: |-
        Begin SSO device-code binding for an enrolled-but-unidentified device.

        The agent shows ``verification_uri`` (already carrying the code) to the
        employee; completing workspace SSO there binds this device to them.
      operationId: identity_start_api_runtime_security_agent_identity_start_post
      parameters:
        - name: X-Blindsight-Device-Token
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Blindsight-Device-Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IdentityStartResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    IdentityStartResponse:
      properties:
        verification_uri:
          type: string
          title: Verification Uri
        user_code:
          type: string
          title: User Code
        expires_in:
          type: integer
          title: Expires In
        identity_status:
          type: string
          title: Identity Status
      type: object
      required:
        - verification_uri
        - user_code
        - expires_in
        - identity_status
      title: IdentityStartResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````