Update job title for a contract | Deel

Use this API to update the job title for a contract. Provide the contract ID and new job title details to make a change. Token scopes: contracts:write

Authentication

AuthorizationBearer

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Path parameters

contract_idstringRequired

The unique identifier of the GP contract.

Request

Job title change details including effective date and new job title.

dataobjectRequired

Response

Job title change created successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

The unique identifier of the GP contract.

Job title change details including effective date and new job title.

Job title change created successfully.

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

$	curl -X PATCH https://api.letsdeel.com/rest/v2/gp/contracts/abc123xyz/job-title \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": {
>	"job_title": "Senior Software Engineer",
>	"effective_date": "2026-04-01"
>	}
>	}'

1	{
2	"data": {
3	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
4	"scope": "JOB_TITLE",
5	"is_active": true,
6	"job_title": "Senior Software Engineer",
7	"created_at": "2026-03-17T10:00:00.000Z",
8	"contract_id": "abc123xyz",
9	"effective_date": "2026-04-01"
10	}
11	}

$	curl -X PATCH https://api.letsdeel.com/rest/v2/gp/contracts/abc123xyz/job-title \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": {
>	"job_title": "Senior Software Engineer",
>	"effective_date": "2026-04-01"
>	}
>	}'

1	{
2	"data": {
3	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
4	"scope": "JOB_TITLE",
5	"is_active": true,
6	"job_title": "Senior Software Engineer",
7	"created_at": "2026-03-17T10:00:00.000Z",
8	"contract_id": "abc123xyz",
9	"effective_date": "2026-04-01"
10	}
11	}

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'