Edit a legal entity | Deel

Applies a partial update to an existing legal entity identified by id; only fields included in the request body are modified. Token scopes: legal-entity:read, legal-entity: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

idstringRequired

The ID of the legal entity to update.

Request

This endpoint expects an object.

namestringOptional

The name of the legal entity.

phonestringOptional

The phone number of the legal entity.

addressobjectOptional

sic_numberstringOptional

The SIC number of the legal entity.

entity_typestringOptional

The type of the legal entity.

industry_namestringOptional

The industry name of the legal entity.

company_identifiersobjectOptional

Identifiers associated with the legal entity.

Response

Successfully updated the legal entity.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found 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 ID of the legal entity to update.

This endpoint expects an object.

The name of the legal entity.

The phone number of the legal entity.

The SIC number of the legal entity.

The type of the legal entity.

The industry name of the legal entity.

Identifiers associated with the legal entity.

Successfully updated the legal entity.

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/

$	curl -X PATCH https://api.letsdeel.com/rest/v2/legal-entities/123e4567-e89b-12d3-a456-426614174000 \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"data": {
3	"id": "123e4567-e89b-12d3-a456-426614174000",
4	"name": "Deel Inc.",
5	"phone": "+18001234567",
6	"address": {
7	"city": "San Francisco",
8	"state": "CA",
9	"street": "123 Main St",
10	"country": "US"
11	},
12	"sic_number": "1234",
13	"entity_type": "Corporation",
14	"industry_name": "Software Development",
15	"company_identifiers": {
16	"tax_number": "123456789",
17	"registration_number": "987654321"
18	}
19	}
20	}

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