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

> ## Agent Instructions
> For AgentScope Python, use https://docs.agentscope.io/stable/en/index for new projects. For existing projects, check the installed agentscope version and use matching versioned documentation.
> The /latest/ alias points to development documentation. Use it only with the matching development source. Do not mix AgentScope 1.x and 2.x APIs.
> State the AgentScope version when providing installation commands or code examples. ReMe uses its own continuously updated /reme/latest/ documentation.

# Poll Credential Binding

> Report the session, asking the platform once when due.

Never returns the credentials themselves — those are handed over
only by creating a channel with this ``binding_id``.



## OpenAPI

````yaml /en/versions/2.0.9/deploy/openapi.json get /channels/bindings/{binding_id}
openapi: 3.1.0
info:
  title: AgentScope
  version: 2.0.9
servers: []
security: []
paths:
  /channels/bindings/{binding_id}:
    get:
      tags:
        - channels
      summary: Poll Credential Binding
      description: |-
        Report the session, asking the platform once when due.

        Never returns the credentials themselves — those are handed over
        only by creating a channel with this ``binding_id``.
      operationId: poll_credential_binding_channels_bindings__binding_id__get
      parameters:
        - name: binding_id
          in: path
          required: true
          schema:
            type: string
            title: Binding Id
        - name: x-user-id
          in: header
          required: true
          schema:
            type: string
            description: >-
              Caller's user ID. Temporary header-based identity; will be
              replaced by JWT auth.
            title: X-User-Id
          description: >-
            Caller's user ID. Temporary header-based identity; will be replaced
            by JWT auth.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BindingView'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    BindingView:
      properties:
        binding_id:
          type: string
          title: Binding Id
        state:
          $ref: '#/components/schemas/BindingState'
        verification_url:
          type: string
          title: Verification Url
          default: ''
        error:
          type: string
          title: Error
          default: ''
        retry_after_secs:
          type: integer
          title: Retry After Secs
          default: 5
      type: object
      required:
        - binding_id
        - state
      title: BindingView
      description: What a client is allowed to see while a session is open.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BindingState:
      type: string
      enum:
        - pending
        - authorized
        - failed
        - cancelled
      title: BindingState
      description: Where a binding session is in its lifecycle.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````