Skip to main content
PATCH
/
identity
/
v1
/
users
/
{id}
Updates profile fields for a user in a downstream organization.
curl --request PATCH \
  --url https://api.sandbox.tesouro.com/identity/v1/users/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address1": "<string>",
  "address2": "<string>",
  "city": "<string>",
  "country": "<string>",
  "isExpenseApprover": true,
  "jobTitle": "<string>",
  "name": "<string>",
  "permissions": {
    "grant": [
      "<string>"
    ],
    "revoke": [
      "<string>"
    ]
  },
  "phoneNumber": "<string>",
  "postalCode": "<string>",
  "reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "role": "ADMIN",
  "stateOrProvince": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "email": "<string>",
  "isExpenseApprover": true,
  "name": "<string>",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "role": "ADMIN",
  "status": "<string>",
  "address1": "<string>",
  "address2": "<string>",
  "city": "<string>",
  "country": "<string>",
  "jobTitle": "<string>",
  "phoneNumber": "<string>",
  "postalCode": "<string>",
  "reportingManagerUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "stateOrProvince": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Path Parameters

​
id
string<uuid>
required

The user ID to update.

Body

Cancellation token.

​
address1
null | string
​
address2
null | string
​
city
null | string
​
country
null | string
​
isExpenseApprover
null | boolean
​
jobTitle
null | string
​
name
null | string
​
permissions
object

Explicit grant/revoke deltas for the user's permissions. Permissions not listed in either array are left untouched, so a caller managing only a subset of permissions does not have to round-trip every permission the target already holds.

​
phoneNumber
null | string
​
postalCode
null | string
​
reportingManagerUserId
null | string<uuid>

The ID of the user's reporting manager. Three states: absent = leave unchanged, null = clear, value = set to the provided ID.

​
role
null | enum<string>
Available options:
ADMIN,
BOOKKEEPER,
EMPLOYEE,
TREASURY_MANAGER
​
stateOrProvince
null | string

Response

User updated successfully.

​
id
string<uuid>
required
​
email
string
required
​
isExpenseApprover
boolean
required
​
name
string
required
​
organizationId
string<uuid>
required
​
role
enum<string>
required
Available options:
ADMIN,
BOOKKEEPER,
EMPLOYEE,
TREASURY_MANAGER
​
status
string
required
​
address1
null | string
​
address2
null | string
​
city
null | string
​
country
null | string
​
jobTitle
null | string
​
phoneNumber
null | string
​
postalCode
null | string
​
reportingManagerUserId
null | string<uuid>
​
stateOrProvince
null | string