curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts/{externalAccountId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "<string>"
}
'{
"externalAccount": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "card",
"status": "processing",
"label": "<string>",
"asset": "<string>",
"features": [
"withdraw"
],
"details": {
"last4Digits": "<string>",
"expiryDate": {
"month": 123,
"year": 123
},
"octSupport": "unknown",
"type": "credit"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"statusDetails": {
"reason": "card-data-invalid"
},
"network": "<string>"
}
}Update external account
Update an external account for the user.
curl --request PATCH \
--url https://api.enterprise.sandbox.uphold.com/core/external-accounts/{externalAccountId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "<string>"
}
'{
"externalAccount": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "card",
"status": "processing",
"label": "<string>",
"asset": "<string>",
"features": [
"withdraw"
],
"details": {
"last4Digits": "<string>",
"expiryDate": {
"month": 123,
"year": 123
},
"octSupport": "unknown",
"type": "credit"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"statusDetails": {
"reason": "card-data-invalid"
},
"network": "<string>"
}
}Authorizations
OAuth 2.0 authentication.
Path Parameters
The external account identifier.
Body
The label of the external account.
140Response
External account updated.
Show child attributes
Show child attributes
The unique identifier of the external account.
The unique identifier of the user that owns the account.
The type of the external account.
card, bank The status of the external account.
processing, ok, expired, failed, restricted, blocked The label of the external account.
The asset in which the external account is denominated.
The features of the external account.
withdraw, deposit The details of the external account based on the type and network.
- Card
- Bank (FPS)
Show child attributes
Show child attributes
The last 4 digits of the card number.
The support for Open Credit Transfer (withdrawals) for the card.
unknown, supported, unsupported The type of the card, available if card was recognized.
credit, debit The time at which the external account was created.
The last time at which the external account was updated.
The details of the status of the external account.
Show child attributes
Show child attributes
The reason why the external account is in its current status.
card-data-invalid, card-declined-by-bank, card-expired, card-permanently-declined-by-bank, card-unauthorized, card-unsupported, bank-account-holder-name-mismatch, velocity, under-review, unspecified-error The network that the external account corresponds to.