Update an Account Capability
POST / v1 / accounts /:id / capabilities /:id
Updates an existing Account Capability. Request or remove a capability by updating its requested parameter.
Parameters
- requested boolean To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the
requirementsarrays. If a capability isn’t permanent, you can remove it from the account by passing false. Some capabilities are permanent after they’ve been requested. Attempting to remove a permanent capability returns an error.
More parameters
- preview boolean Preview feature
Returns
Returns an Account Capability object.
Response
{ "id": "card_payments", "object": "capability", "account": "acct_1032D82eZvKYlo2C", "future_requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": null, "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "requested": true, "requested_at": 1688491010, "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": null, "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "status": "inactive"}
Retrieve an Account Capability
GET / v1 / accounts /:id / capabilities /:id
Retrieves information about the specified Account Capability.
Parameters
No parameters.
Returns
Returns an Account Capability object.
Response
{ "id": "card_payments", "object": "capability", "account": "acct_1032D82eZvKYlo2C", "future_requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": null, "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "requested": true, "requested_at": 1688491010, "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": null, "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, "status": "inactive"}
List all account capabilities
GET / v1 / accounts /:id / capabilities
Returns a list of capabilities associated with the account. The capabilities are returned sorted by creation date, with the most recent capability appearing first.
Parameters
No parameters.
Returns
A dictionary with a data property that contains an array of the capabilities of this account. Each entry in the array is a separate capability object.
Response