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>'import requests
url = "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"x-idempotency-key": "<x-idempotency-key>",
"X-Auth-Token": "<x-auth-token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
platform: '<platform>',
uuid: '<uuid>',
'x-idempotency-key': '<x-idempotency-key>',
'X-Auth-Token': '<x-auth-token>'
}
};
fetch('https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Auth-Token: <x-auth-token>",
"platform: <platform>",
"uuid: <uuid>",
"x-idempotency-key: <x-idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("X-Auth-Token", "<x-auth-token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("x-idempotency-key", "<x-idempotency-key>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["x-idempotency-key"] = '<x-idempotency-key>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyAPI Endpoints
Change Account Permission
Changes the permission level for a specific account.
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>'import requests
url = "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}"
headers = {
"platform": "<platform>",
"uuid": "<uuid>",
"x-idempotency-key": "<x-idempotency-key>",
"X-Auth-Token": "<x-auth-token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
platform: '<platform>',
uuid: '<uuid>',
'x-idempotency-key': '<x-idempotency-key>',
'X-Auth-Token': '<x-auth-token>'
}
};
fetch('https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Auth-Token: <x-auth-token>",
"platform: <platform>",
"uuid: <uuid>",
"x-idempotency-key: <x-idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("platform", "<platform>")
req.Header.Add("uuid", "<uuid>")
req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
req.Header.Add("X-Auth-Token", "<x-auth-token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}")
.header("platform", "<platform>")
.header("uuid", "<uuid>")
.header("x-idempotency-key", "<x-idempotency-key>")
.header("X-Auth-Token", "<x-auth-token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{tenant}.fincode.software/api/v6/services/account-maintenance/change-account-permission/{id}/{permission}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["platform"] = '<platform>'
request["uuid"] = '<uuid>'
request["x-idempotency-key"] = '<x-idempotency-key>'
request["X-Auth-Token"] = '<x-auth-token>'
response = http.request(request)
puts response.read_bodyUpdates the account permission, allowing customers to control access and transaction capabilities for their accounts.
Request Headers
string
required
The JWT Access Token obtained from the
/login or /refresh-token endpoint.string
required
Unique idempotency key for the request to prevent duplicate processing.
string
required
The date and time at which the request was initiated (ISO 8601 format).
string
required
The IP address of the customer making the request.
string
required
Unique identifier for the interaction/session.
Path Parameters
string
required
The unique identifier (UUID) of the account to update permissions for.
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'
const axios = require('axios');
const BASE_URL = 'https://{domain}.fincode.software/api/v6/services/account-maintenance';
async function changeAccountPermission(accessToken, accountId, permission) {
try {
const response = await axios.get(
`${BASE_URL}/change-account-permission/${accountId}/${permission}`,
{
headers: {
'X-Auth-Token': accessToken,
'x-idempotency-key': `key-${Date.now()}`,
'x-fapi-auth-date': new Date().toISOString(),
'x-fapi-customer-ip-address': '192.168.1.1',
'x-fapi-interaction-id': `interaction-${Date.now()}`,
},
}
);
console.log('Account permission updated:', response.data.data);
return response.data.data;
} catch (error) {
console.error(
'Failed to change account permission:',
error.response?.data || error.message
);
throw error;
}
}
⌘I