Update an approver on an approval section item
Updates an existing approver on an approval section item. The body must contain the approver’s id (which must match the approverId in the URL), the sectionItemId the approver belongs to, and the target level. The organizationId path parameter supports both the Findity id and the partner-side externalId.
curl --request PUT \
--url https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"sectionItemId": "1528b743a5c44eb5963b6dd53a98c43b",
"level": 2,
"amountLimit": 750
}
'import requests
url = "https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}"
payload = {
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"sectionItemId": "1528b743a5c44eb5963b6dd53a98c43b",
"level": 2,
"amountLimit": 750
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '8ab28c4f6f1da520016f23777f0e01a9',
sectionItemId: '1528b743a5c44eb5963b6dd53a98c43b',
level: 2,
amountLimit: 750
})
};
fetch('https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}', 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://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '8ab28c4f6f1da520016f23777f0e01a9',
'sectionItemId' => '1528b743a5c44eb5963b6dd53a98c43b',
'level' => 2,
'amountLimit' => 750
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}"
payload := strings.NewReader("{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}"
response = http.request(request)
puts response.read_body{
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"personId": "ff8080819e74371c019e7437518600fa",
"personExternalId": null,
"firstName": "FirstName1",
"lastName": "LastName1",
"email": "firstName1.lastName1@test.com",
"level": 1,
"amountLimit": 500
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Unique identifier of the organization. String in UUID without dashes (32-character hex string) if access is done via values from Findity system otherwise, id of external system can be used
UUID without dashes (32-character hex string)
^[0-9a-fA-F]{32}$UUID without dashes (32-character hex string)
^[0-9a-fA-F]{32}$Body
Request body for updating an existing approver on a section item. The id field must match an existing approver on the section item. Only the fields present in the body are updated.
Findity identifier of the approver being updated (as returned from GET or POST).
^[0-9a-fA-F]{32}$Identifier of the approval section item this approver belongs to. For DEPARTMENT sections this is the organizational unit id; for DIMENSION sections this is the custom dimension list value id.
255Zero-based sequential approval level at which this approver acts. Must be greater than or equal to 0; approvers are processed from lowest (0) to highest level.
x >= 0Findity identifier of the person acting as approver. Provide either personId or personExternalId.
^[0-9a-fA-F]{32}$External source identifier of the person acting as approver. Ignored if personId is also provided.
255Maximum expense report amount this approver is authorized to approve, expressed in the organization's base currency. Send null to clear the limit.
x >= 0Response
Approver successfully updated
An approver assigned to an approval section item at a specific level.
Findity unique identifier of the approver record (not the person). Use this value when updating or deleting the approver.
^[0-9a-fA-F]{32}$Findity identifier of the person acting as approver.
^[0-9a-fA-F]{32}$Sequential approval level of this approver within the section item. Approvers are processed from lowest to highest level.
x >= 0External source identifier of the person as provided by the integrating system. Null if not set.
255First name of the approver.
255Last name of the approver.
255Email address of the approver.
255Maximum expense report amount this approver is authorized to approve, expressed in the organization's base currency. Null indicates no upper limit applies.
x >= 0Display metadata for the approver. Present only on GET responses when the request includes the query parameter include=approver.meta.abbreviation. Never returned on POST/PUT responses.
Hide child attributes
Hide child attributes
Full name of the approver, formatted as "firstName lastName".
511Full name with email address, formatted as "firstName lastName (email@example.com)".
511Localized, currency-formatted representation of the approver's amountLimit using the organization's base currency (e.g. "200,10 SEK"). Null when amountLimit is null.
64curl --request PUT \
--url https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"sectionItemId": "1528b743a5c44eb5963b6dd53a98c43b",
"level": 2,
"amountLimit": 750
}
'import requests
url = "https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}"
payload = {
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"sectionItemId": "1528b743a5c44eb5963b6dd53a98c43b",
"level": 2,
"amountLimit": 750
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: '8ab28c4f6f1da520016f23777f0e01a9',
sectionItemId: '1528b743a5c44eb5963b6dd53a98c43b',
level: 2,
amountLimit: 750
})
};
fetch('https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}', 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://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'id' => '8ab28c4f6f1da520016f23777f0e01a9',
'sectionItemId' => '1528b743a5c44eb5963b6dd53a98c43b',
'level' => 2,
'amountLimit' => 750
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}"
payload := strings.NewReader("{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://stage-api.findity.com/api/v1/admin/organizations/{organizationId}/approval/sections/{sectionId}/approvers/{approverId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"8ab28c4f6f1da520016f23777f0e01a9\",\n \"sectionItemId\": \"1528b743a5c44eb5963b6dd53a98c43b\",\n \"level\": 2,\n \"amountLimit\": 750\n}"
response = http.request(request)
puts response.read_body{
"id": "8ab28c4f6f1da520016f23777f0e01a9",
"personId": "ff8080819e74371c019e7437518600fa",
"personExternalId": null,
"firstName": "FirstName1",
"lastName": "LastName1",
"email": "firstName1.lastName1@test.com",
"level": 1,
"amountLimit": 500
}