How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Deel subpackage_organizations API

The subpackage_organizations API from Deel — 7 operation(s) for subpackage_organizations.

Deel subpackage_organizations API is one of 91 APIs that Deel publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and an AsyncAPI specification.

This API exposes 8 operations across 7 paths, and defines 37 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.letsdeel.com/rest/v2, https://api-staging.letsdeel.com/rest/v2.

8 operations 7 paths 37 schemas 5 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
https://api.letsdeel.com/rest/v2
https://api-staging.letsdeel.com/rest/v2
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Deel subpackage_organizations API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (deelToken). It accepts HTTP bearer tokens (oauth2).

  • deelToken — Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authenticatio…
  • oauth2 — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 5 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

subpackage_organizations 8
POST
/organizations/children
Create child organization
create-organization-child 1 param body → 201400401403404500
GET
/organizations
Get Current Organization
get-organizations 1 param → 200400401403404500
POST
/roles
Create organization custom role.
create-organization-role 1 param body → 200400401403404500
GET
/roles
Get the roles of the current organization.
get-the-roles-of-the-current-organization-v-2026-01-01 1 param → 200400401403404500
GET
/teams
Get Team List
get-teams 1 param → 200400401403404500
GET
/departments
Retrieve Departments
get-departments 1 param → 200400401403404500
GET
/working-locations
Retrieve working locations
retrieve-working-locations 1 param → 200400401403404500
PATCH
/roles/{roleId}
Update organization custom role
update-organization-role 2 params body → 200400401403404500

Schemas 37

The contract defines 37 schemas that model the data the API accepts and returns. The most detailed are ApiErrorRequest (7 properties), OrganizationsChildrenPostResponsesContentApplicationJsonSchemaRequest (7 properties), Organizations_CreateOrganizationRole_Response_200 (6 properties), OrganizationsChildrenPostRequestBodyContentApplicationJsonSchemaDataChildOrganization (5 properties). Each schema is shown below with its type and property counts.

Organizations_GetDepartments_Response_200
object
1 property
Organizations_UpdateOrganizationRole_Response_200
object
5 properties
OrganizationsChildrenPostResponsesContentApplicationJsonSchemaErrorsItems
object
2 properties
OrganizationsChildrenPostRequestBodyContentApplicationJsonSchemaDataParentOrganization
object
The object that contains the information related to the parentorganization.
1 property
organizations_getOrganizations_Response_200
object
1 property
RolesPostRequestBodyContentApplicationJsonSchemaData
object
5 properties 4 required
Organizations_getTheRolesOfTheCurrentOrganization-v2026-01-01_Response_200
object
1 property 1 required
GetDepartmentsRequestNotFoundError
object
1 property
GetTeamsRequestInternalServerError
object
1 property
GetTheRolesOfTheCurrentOrganization-v2026-01-01RequestBadRequestError
object
1 property
Organizations_retrieveWorkingLocations_Response_200
object
1 property 1 required
OrganizationsChildrenPostResponsesContentApplicationJsonSchemaRequest
object
7 properties
OrganizationsChildrenPostRequestBodyContentApplicationJsonSchemaDataChildOrganization
object
The object that contains all the information related to the child organization that will be created.
5 properties 1 required
GetDepartmentsRequestUnauthorizedError
object
1 property
GetOrganizationsRequestNotFoundError
object
1 property
GetTheRolesOfTheCurrentOrganization-v2026-01-01RequestUnauthorizedError
object
1 property
organizations_createOrganizationChild_Response_201
object
1 property 1 required
ApiError
object
2 properties
RolesRoleIdPatchRequestBodyContentApplicationJsonSchemaData
object
3 properties
ApiErrorContainer
object
2 properties
Organizations_CreateOrganizationRole_Response_200
object
6 properties
GetTeamsRequestUnauthorizedError
object
1 property
Organizations_getTeams_Response_200
object
1 property 1 required
TeamsGetResponsesContentApplicationJsonSchemaDataItems
object
2 properties 2 required
DepartmentsGetResponsesContentApplicationJsonSchemaDataItems
object
3 properties 2 required
GetDepartmentsRequestInternalServerError
object
1 property
GetTeamsRequestNotFoundError
object
1 property
OrganizationsChildrenPostRequestBodyContentApplicationJsonSchemaData
object
The request payload.
2 properties 2 required
WorkingLocationsGetResponsesContentApplicationJsonSchemaDataItems
object
2 properties 2 required
RolesGetResponsesContentApplicationJsonSchemaDataItems
object
4 properties 3 required
GetOrganizationsRequestInternalServerError
object
1 property
GetOrganizationsRequestUnauthorizedError
object
1 property
OrganizationsChildrenPostResponsesContentApplicationJsonSchemaData
object
4 properties 4 required
GetTheRolesOfTheCurrentOrganization-v2026-01-01RequestInternalServerError
object
1 property
OrganizationsGetResponsesContentApplicationJsonSchemaDataItems
object
2 properties 2 required
ApiErrorRequest
object
7 properties
CreateChildOrganizationRequestBadRequestError
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

deel-subpackage-organizations-api-openapi.yml Raw ↑

Other APIs Deel publishes across the network.

Deel Default API
Deel subpackage_accounting API
Deel subpackage_adjustments API
Deel subpackage_assets API
Deel subpackage_ats API
Deel subpackage_candidates API
Deel subpackage_consent API
Deel subpackage_contractorAmendments API
Deel subpackage_contractorHiring API
Deel subpackage_contracts API
Deel subpackage_costCalculator API
Deel subpackage_costCenters API
Where this information came from

This is an independent, third-party profile of Deel subpackage_organizations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.