Update person rate

curl --request PATCH \ --url https://api.agile-tools.io/v1/public/person-rates/{id} \ --header 'Content-Type: application/merge-patch+json' \ --header 'X-API-Key: <api-key>' \ --data '{ "costRate": 50 }'

{ "data": { "id": "2f6db7d4-6e6c-4d4f-90f2-cbaac8441f7b", "personId": "0f3e8793-4caf-4705-826d-491e25988924", "personName": "Calvin Tyler Osborne", "costRate": 45, "billingRate": 90, "currencyUnitId": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "effectiveDate": "2026-01-01", "externalId": "PERSON_RATE_2026_Q1" }, "meta": { "requestId": "f056699e-497d-41d9-a877-d7c862de6587", "timestamp": "2026-04-03T12:08:00Z" } }

Authorizations

X-API-Key

string

header

required

Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.

Path Parameters

string

required

Body

application/merge-patch+json

Merge-patch payload for person-rate updates. Omitted fields remain unchanged. Explicit null clears externalId.

costRate

number | null

Fully-loaded internal cost per hour. Omit to keep unchanged.

Example:

50

billingRate

number | null

External client price per hour. Omit to keep unchanged.

Example:

100

currencyUnitId

string | null

Id of the currency unit. Omit to keep unchanged.

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

effectiveDate

string<date> | null

Date the rate becomes effective. Omit to keep unchanged.

Example:

"2026-07-01"

externalId

string | null

External system identifier. Provide null to clear it.

Example:

"PERSON_RATE_2026_H2"

Response

Person rate updated

string

personId

string

personName

string

costRate

number

billingRate

number

currencyUnitId

string

effectiveDate

string<date>

Example:

"2022-03-10"

externalId

string

API

API Reference

API Guides

CLI

Integration Automation

Support

Authorizations

Path Parameters

Body

Response