> ## Documentation Index > Fetch the complete documentation index at: https://docs.stableyard.fi/llms.txt > Use this file to discover all available pages before exploring further. # Withdraw claim reuse consent > Stop reusing the account holder's saved compliance answers in future capability activations. Call this when the account holder withdraws consent to reuse their saved compliance answers. Send a `reason` of 10 to 500 characters. The call is idempotent. A later capability activation may ask the account holder for those answers again. Withdrawing consent does not recall information already shared, and capabilities that are already approved stay approved. ## OpenAPI ````yaml openapi.json POST /v2/accounts/{accountId}/compliance-claim-reuse/revocations openapi: 3.1.0 info: title: Stableyard Partner API version: 2.0.0 x-stableyard-api-version: '2026-09-09' x-stableyard-supported-api-versions: - '2026-09-09' summary: Backend API for UPAs, Payments, activity, and optional financial products. description: > Use this API from a trusted partner backend with an app ID and app secret. ## Recommended integration 1. Call `GET /v2/partners/config` to verify credentials and discover enabled capabilities. 2. Create a UPA only when your product needs a persistent Stableyard account. 3. Create a receive or send Payment with `POST /v2/payments`. 4. Redirect a payer to the returned `paymentUrl` or pass the Payment credentials to an official Stableyard interface SDK. 5. Process signed webhooks and fetch the Payment by ID for reconciliation. Checkout execution and account-bound browser endpoints are documented in the separate Interfaces & SDKs reference. x-stableyard-documentation-surface: partner servers: - url: https://prod-api.stableyard.fi description: Production - url: https://staging-api-v2.stableyard.fi description: Sandbox security: [] tags: - name: Authentication x-displayName: API authentication description: Verify your app ID and app secret before calling UPA APIs. - name: Accounts x-displayName: UPA Accounts description: Create Universal Payment Accounts and manage account settings. - name: Deposit Addresses description: Create reusable receive addresses and verify inbound deposits. - name: Identity & KYC description: >- Verify the UPA email and run identity verification. Managed vaults and fiat payment rails use this same verified UPA identity. - name: Vaults description: >- Create policy-controlled stablecoin vaults and manage policy updates for accounts. - name: Payments description: >- Create escrow-first payments, issue partner-authenticated send instructions or executions, power public checkout, and reconcile collection through final account settlement. - name: Balances & Transactions description: >- Read Stableyard-posted financial activity. Balances are ledger projections of activity Stableyard processed; they are not live balances of externally controlled wallets. paths: /v2/accounts/{accountId}/compliance-claim-reuse/revocations: post: tags: - Identity & KYC summary: Withdraw reusable compliance-claim consent description: >- Prevents every currently active self-attested compliance claim on this UPA from being reused in future regulated-capability actions. This operation is idempotent. Data already shared under an earlier consent is not recalled. Call it when the account holder withdraws permission for future reuse; a later hosted action may collect and freshly consent replacement claims. operationId: revokeAccountComplianceClaimReuse parameters: - name: accountId in: path required: true schema: type: string example: acct_123 description: Canonical account id returned by the Accounts API. - name: Stableyard-Version in: header required: false schema: type: string enum: - '2026-09-09' description: >- Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RevokeComplianceClaimReuseRequest' examples: example: summary: Withdraw reusable compliance-claim consent request value: reason: The account holder withdrew consent for future claim reuse. responses: '200': description: Reusable-claim consent state headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/RevokeComplianceClaimReuseResponse' examples: example: summary: Withdraw reusable compliance-claim consent 200 response value: accountId: acct_123 claimReuse: status: revoked revokedCount: 3 revokedAt: '2026-08-28T10:00:00.000Z' '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' '424': $ref: '#/components/responses/FailedDependency' '429': $ref: '#/components/responses/TooManyRequests' security: - partnerBasicAuth: [] components: schemas: RevokeComplianceClaimReuseRequest: type: object additionalProperties: false required: - reason properties: reason: type: string minLength: 10 maxLength: 500 example: The account holder withdrew consent for future claim reuse. RevokeComplianceClaimReuseResponse: type: object additionalProperties: false required: - accountId - claimReuse properties: accountId: type: string pattern: ^acct_[A-Za-z0-9_-]+$ example: acct_123 claimReuse: type: object additionalProperties: false required: - status - revokedCount - revokedAt properties: status: type: string const: revoked revokedCount: type: integer minimum: 0 example: 3 revokedAt: type: string format: date-time ErrorResponse: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string minLength: 1 maxLength: 128 example: bad_request message: type: string minLength: 1 maxLength: 1000 example: The request is invalid details: {} responses: BadRequest: description: Bad request headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: bad_request value: error: code: bad_request message: The request is invalid Unauthorized: description: Unauthorized headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: unauthorized value: error: code: unauthorized message: Authentication is required Forbidden: description: The app secret does not include the required scope headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: forbidden value: error: code: forbidden message: The credential does not allow this operation NotFound: description: Not found headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: not_found value: error: code: not_found message: The resource was not found Conflict: description: Conflict headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: idempotency_conflict value: error: code: idempotency_conflict message: >- The Idempotency-Key was already used with a different request FailedDependency: description: This feature is not configured for your app or environment headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: chain_config_missing value: error: code: chain_config_missing message: The requested network is not configured for this environment TooManyRequests: description: Too many requests. Retry after the `Retry-After` interval. headers: Stableyard-Version: description: >- Effective date-based Stableyard API contract version for this response. schema: type: string enum: - '2026-09-09' Retry-After: description: Seconds until the caller should retry. schema: type: integer minimum: 1 RateLimit-Limit: description: Quota for the most constrained policy. schema: type: integer minimum: 1 RateLimit-Remaining: description: Requests remaining in that policy window. schema: type: integer minimum: 0 RateLimit-Reset: description: Seconds until that policy window resets. schema: type: integer minimum: 0 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: example: summary: rate_limited value: error: code: rate_limited message: Too many requests securitySchemes: partnerBasicAuth: type: http scheme: basic description: >- HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.