For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • Platform
    • Introduction
    • Screenings
    • Immigration
  • Endpoints
      • POSTCreate a new legal entity
      • DELDelete a legal entity
      • PATCHEdit a legal entity
      • GETList all industry subcategories
      • GETList of legal entities
LogoLogo
SupportDeel Home
EndpointsLegal Entities

Delete a legal entity

DELETE
/legal-entities/:id
DELETE
/rest/v2/legal-entities/:id
$curl -X DELETE https://api.letsdeel.com/rest/v2/legal-entities/123e4567-e89b-12d3-a456-426614174000 \
>     -H "Authorization: Bearer <token>"
1{
2  "archived_at": "2024-11-29T12:00:00Z"
3}

Archives the legal entity identified by id, marking it as inactive without permanently removing it; the response includes the archived_at timestamp. Token scopes: legal-entity:read, legal-entity:write

Was this page helpful?
Previous

Edit a legal entity

Next
Built with

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.

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

Learn more about authentication

OR
AuthorizationBearer

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

Path parameters

idstringRequired
The ID of the legal entity to archive.

Response

Successfully archived the legal entity.
archived_atstringformat: "date-time"
The timestamp when the legal entity was archived.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error