Update an authorisation control beta

Updates the details of a given authorisation control.

SecurityCommonAuth
Request
path Parameters
cardId
required
string <uuid> (cardId) <= 36 characters

The ID of the card to work with.

Example: e9293471-5eb3-4dbc-916c-dbaf9e2deefd
authControlId
required
string <uuid> <= 36 characters

The ID of the authorisation control to work with.

Example: e9293471-5eb3-4dbc-916c-dbaf9e2deefd
query Parameters
accountId
required
string (accountId)

The ID of the account to work with.

Example: accountId=C5462
personId
string <uuid> (personId) <= 36 characters

The ID of the person.

Example: personId=775596ae-2624-40af-a9dc-9756110a4a04
Request Body schema: application/json
name
string <= 255 characters

The name of the authorisation control.

active
boolean
Default: true

Whether or not the authorisation control is active.

startTime
string <date-time>

The date and time at which the control goes into effect, in UTC.

endTime
string <date-time>

The date and time at which the control ends, in UTC.

object

Details about the merchant scope. When provided, only one of mcc`` or mid``` is required.

Responses
200

OK

400

Bad request

401

Unauthorised

403

Forbidden

404

Not found

405

Method not allowed

415

Unsupported media type

429

Too many requests

500

Internal server error

put/cards/{cardId}/auth-controls/{authControlId}
Request samples
application/json
{
  • "name": "Spending controls",
  • "active": true,
  • "startTime": "2023-03-14T12:08:53Z",
  • "endTime": "2023-03-14T12:08:53Z",
  • "merchantScope": {
    }
}
Response samples
application/json
{
  • "name": "Spending controls",
  • "id": "a1e54aed-8a68-4602-a792-30f4c67497cf",
  • "active": true,
  • "startTime": "2023-03-14T12:08:53Z",
  • "endTime": "2023-03-14T12:08:53Z",
  • "merchantScope": {
    }
}