Skip to main content
GET
/
account-maintenance
/
change-account-permission
/
{id}
/
{permission}
Change Account Permission
curl --request GET \
  --url https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission} \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --header 'x-idempotency-key: <x-idempotency-key>'
Updates the account permission, allowing customers to control access and transaction capabilities for their accounts.

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
x-idempotency-key
string
required
Unique idempotency key for the request to prevent duplicate processing.
​
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
​
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
​
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the account to update permissions for.
​
permission
string
required
The new permission level to set for the account. Valid values depend on the account permission enum.

​
Code Examples

curl --location 'https://{domain}.fincode.software/api/v6/services/account-maintenance/change-account-permission/123e4567-e89b-12d3-a456-426614174000/READ_ONLY' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-idempotency-key: unique-key-12345' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
x-idempotency-key
string
required
​
X-Auth-Token
string
required

Path Parameters

​
id
string
required
​
permission
string
required

Response

200

Updated account