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

# Reject pending operation

> This operation rejects a pending operation, preventing it from being executed. The pending operation ID can be retrieved by calling the List pending operations operation. Only the wallet owner principal can reject pending operations. For unpaired agent-owned wallets, the same agent principal is also the wallet owner. Optionally supply `reason` (max 500 characters) to record why the operation was rejected.



## OpenAPI

````yaml post /api/v1/pending-operations/{pending_operation_id}/reject
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/pending-operations/{pending_operation_id}/reject:
    post:
      tags:
        - Pending Operations
      summary: Reject pending operation
      description: >-
        This operation rejects a pending operation, preventing it from being
        executed. The pending operation ID can be retrieved by calling the List
        pending operations operation. Only the wallet owner principal can reject
        pending operations. For unpaired agent-owned wallets, the same agent
        principal is also the wallet owner. Optionally supply `reason` (max 500
        characters) to record why the operation was rejected.
      operationId: reject_pending_operation
      parameters:
        - name: pending_operation_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: >-
              The unique identifier of the pending operation to reject. Obtain
              this ID from the List pending operations operation.
            title: Pending Operation Id
          description: >-
            The unique identifier of the pending operation to reject. Obtain
            this ID from the List pending operations operation.
        - 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/RejectPendingOperationRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/StandardResponse_PendingOperationActionResult_
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WrappedValidationError'
components:
  schemas:
    RejectPendingOperationRequest:
      properties:
        reason:
          title: Reason
          description: An optional reason for rejecting this operation. Max 500 characters.
          type: string
          maxLength: 500
          nullable: true
      type: object
      title: RejectPendingOperationRequest
      description: Reject payload for pending operation.
    StandardResponse_PendingOperationActionResult_:
      properties:
        success:
          type: boolean
          title: Success
          default: true
        result:
          $ref: '#/components/schemas/PendingOperationActionResult'
        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[PendingOperationActionResult]
    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'
    PendingOperationActionResult:
      properties:
        pending_operation_id:
          type: string
          format: uuid
          title: Pending Operation Id
          description: The pending operation ID.
        status:
          $ref: '#/components/schemas/PendingOperationStatus'
          description: >-
            The updated status after the action. Possible values: `approved`,
            `rejected`.
        transaction_id:
          title: Transaction Id
          description: >-
            The provider-side transaction ID if execution was triggered after
            approval.
          type: string
          nullable: true
        request_id:
          title: Request Id
          description: The original client-supplied request identifier.
          type: string
          nullable: true
        idempotent:
          type: boolean
          title: Idempotent
          description: >-
            Whether this action was an idempotent replay. `true`: the operation
            was already in the target state.
          default: false
      type: object
      required:
        - pending_operation_id
        - status
      title: PendingOperationActionResult
      description: Action response for approve/reject endpoints.
    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
    PendingOperationStatus:
      type: string
      enum:
        - pending
        - executing
        - rejected
        - executed
      title: PendingOperationStatus
      description: Approval workflow status.

````