Change Account Permission
curl --request GET \
--url https://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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://{your-domain}.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
Path Parameters
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;
}
}
