> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt
> Use this file to discover all available pages before exploring further.

# Report TSS request callback

> This operation is called by your app after the UCW SDK reports a TSS request event (for example, from polling the TSS node). The server fetches the authoritative TSS request state from WaaS and updates the local record. On success, the vault group cache may be refreshed if the request has reached a terminal state.



## OpenAPI

````yaml post /api/v1/wallets/{wallet_uuid}/tss/callback
openapi: 3.1.0
info:
  title: Cobo Agentic Wallet Service
  description: Unified wallet engine for human and agent principals
  version: 1.3.0
servers: []
security: []
paths:
  /api/v1/wallets/{wallet_uuid}/tss/callback:
    post:
      tags:
        - Wallets
      summary: Report TSS request callback
      description: >-
        This operation is called by your app after the UCW SDK reports a TSS
        request event (for example, from polling the TSS node). The server
        fetches the authoritative TSS request state from WaaS and updates the
        local record. On success, the vault group cache may be refreshed if the
        request has reached a terminal state.
      operationId: wallet_tss_callback
      parameters:
        - name: wallet_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Wallet Uuid
        - name: X-API-Key
          in: header
          required: false
          schema:
            title: X-Api-Key
            type: string
            nullable: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WalletTssCallbackRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/StandardResponse_WalletTssCallbackResponse_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WrappedValidationError'
components:
  schemas:
    WalletTssCallbackRequest:
      properties:
        tss_request_id:
          type: string
          minLength: 1
          title: Tss Request Id
          description: WaaS TSS request id.
        status:
          type: integer
          title: Status
          description: UCW SDK Status enum (e.g. Approving=130, Completed=190).
        results:
          title: Results
          items:
            $ref: '#/components/schemas/UcwTssKeyShareGroupCallback'
          type: array
          nullable: true
        failed_reasons:
          title: Failed Reasons
          items:
            type: string
          type: array
          nullable: true
      type: object
      required:
        - tss_request_id
        - status
      title: WalletTssCallbackRequest
      description: >-
        Body from UCW SDK ``TSSRequest`` (e.g. after polling the TSS node).


        Core Engine reconciles state with WaaS using ``get_tss_request_by_id``;
        the numeric ``status``

        field is informational and not written to the database as the source of
        truth.
    StandardResponse_WalletTssCallbackResponse_:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        result:
          $ref: '#/components/schemas/WalletTssCallbackResponse'
        suggestion:
          type: string
          title: Suggestion
          default: ''
        message:
          type: string
          title: Message
          default: ''
        meta:
          $ref: '#/components/schemas/PaginationMeta'
          nullable: true
      type: object
      required:
        - result
      title: StandardResponse[WalletTssCallbackResponse]
    WrappedValidationError:
      title: WrappedValidationError
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
          default: false
          title: Success
        error:
          type: object
          title: Error
          required:
            - detail
          properties:
            detail:
              type: array
              title: Detail
              items:
                $ref: '#/components/schemas/ValidationError'
    UcwTssKeyShareGroupCallback:
      properties:
        id:
          type: string
          title: Id
        created_timestamp:
          type: integer
          title: Created Timestamp
          default: 0
        type:
          type: integer
          title: Type
          description: UCW GroupType enum value (ECDSA=1, EdDSA=2).
        root_extended_public_key:
          type: string
          title: Root Extended Public Key
          default: ''
        chaincode:
          type: string
          title: Chaincode
          default: ''
        curve:
          type: string
          title: Curve
          default: ''
        threshold:
          type: integer
          title: Threshold
          default: 0
        participants:
          title: Participants
          items:
            $ref: '#/components/schemas/UcwSharePublicDataCallback'
          type: array
          nullable: true
      type: object
      required:
        - id
        - type
      title: UcwTssKeyShareGroupCallback
      description: UCW SDK ``TSSKeyShareGroup`` in TSS callback payloads.
    WalletTssCallbackResponse:
      properties:
        tss_request_id:
          type: string
          title: Tss Request Id
        status:
          type: string
          title: Status
          description: TssRequestStatus string aligned with WaaS.
        waas_status_snapshot:
          title: Waas Status Snapshot
          type: string
          nullable: true
      type: object
      required:
        - tss_request_id
        - status
      title: WalletTssCallbackResponse
      description: TSS row after syncing from WaaS.
    PaginationMeta:
      properties:
        total:
          title: Total
          type: integer
          nullable: true
        offset:
          title: Offset
          type: integer
          nullable: true
        limit:
          title: Limit
          type: integer
          nullable: true
        has_more:
          title: Has More
          type: boolean
          nullable: true
        after:
          title: After
          type: string
          nullable: true
        before:
          title: Before
          type: string
          nullable: true
      type: object
      title: PaginationMeta
      description: |-
        Pagination metadata for list responses.

        Supports both legacy offset-based and cursor-based pagination.
        Cursor fields (``has_more``, ``after``, ``before``) are populated for
        cursor-paginated endpoints.  Legacy fields (``offset``, ``limit``) are
        populated when the caller uses the deprecated ``offset`` parameter.
    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
    UcwSharePublicDataCallback:
      properties:
        node_id:
          type: string
          title: Node Id
        share_id:
          type: string
          title: Share Id
        share_public_key:
          type: string
          title: Share Public Key
      type: object
      required:
        - node_id
        - share_id
        - share_public_key
      title: UcwSharePublicDataCallback
      description: UCW SDK ``SharePublicData`` in TSS callback payloads.

````