API explorerPay APIsData APIs

Theme switcher

Revoke Consent

Body Parameters

client_idstring Required

API client identifier

Max length
128
client_secretstring

API client secret for authentication. Required for internal (non-OAuth2) authentication mode (e.g., test-only). Not required when using OAuth2 (Bearer token) authentication.

Max length
128
consent_idstring Required

Consent ID to revoke

Response

200
Object

Consent revoked successfully

Response Attributes

request_idstring
consent_idstring
statusstring

Consent status after revocation - data access is no longer possible

Enum values:
revoked
api_client_appstring

Name of the API client application

400
Object

Validation error or invalid request

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 400 errors:

  • bad_request: Generic validation or request error
  • validation_error: Request payload validation failed
  • invalid_input: Invalid input data provided
  • internal_error: AIS-side unexpected internal error
  • external_api_unavailable: External provider HTTP failure (timeout, connection refused, DNS, etc.). Surfaced as HTTP 400 instead of a gateway 504.
  • external_api_error: External provider returned a structured error during the AIS ...
Enum values:
bad_requestvalidation_errorinvalid_inputinternal_errorexternal_api_unavailableexternal_api_errorcooldown_failedconsent_not_activejob_in_progressmethod_selection_error
... 2 other enums
messagestring Required

Human-readable error message

401
Object

Authentication failed

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 401 errors:

  • unauthorized: Authentication failed or insufficient permissions
Enum values:
unauthorized
messagestring Required

Human-readable error message

404
Object

Resource not found

Response Attributes

error_idstring Required

Unique identifier for this error instance

request_idstring Required

Request identifier for tracking and correlation

codestring Required

Machine-readable error code for 404 errors:

  • not_found: Generic resource not found
  • consent_not_found: Specified consent does not exist
  • job_not_found: Specified job does not exist or outside accessible date range
Enum values:
not_foundconsent_not_foundjob_not_found
messagestring Required

Human-readable error message

Was this section helpful?

POST

/

Select
1

Response

Was this section helpful?
View as Markdown

Ask an AI

Open in ChatGPTOpen in ClaudeOpen in Perplexity

Code with AI

Open in Copilot