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_organizationStructure API

The subpackage_organizationStructure API from Deel — 6 operation(s) for subpackage_organizationstructure.

Deel subpackage_organizationStructure 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.

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

This API exposes 14 operations across 6 paths, and defines 56 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.

14 operations 6 paths 56 schemas 3 DELETE5 GET4 PATCH1 POST1 PUT

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_organizationStructure 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 14

Across 6 paths, the API surfaces 14 operations — 3 DELETE, 5 GET, 4 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

subpackage_organizationStructure 14
POST
/hris/organization_structures
Create a new HRIS Organization Structure.
create-organization-structure 1 param body → 200400401403404500
GET
/hris/organization_structures
Get Organization Structure
get-organization-structures 3 params → 200400401403404500
DELETE
/hris/organization_structures/external/{external_id}
Delete an Org Structure from the Organization by external ID
delete-organization-structure-by-external-id 2 params → 200400401403404500
GET
/hris/organization_structures/external/{external_id}
Fetch an Org Structure from the Organization
get-organization-structure-by-external-id 2 params → 200400401403404500
PATCH
/hris/organization_structures/external/{external_id}
Update an existing HRIS Org Structure by external ID
update-organization-structure-by-external-id 2 params body → 200400401403404500
DELETE
/hris/organization_structures/{hrisOrgStr_id}
Delete Organization Structure
delete-organization-structure 1 param → 200
GET
/hris/organization_structures/{hrisOrgStr_id}
Get Organization Structure
get-organization-structure 1 param → 200
PATCH
/hris/organization_structures/{hrisOrgStr_id}
Update Organization Structure
update-organization-structure 1 param → 200
GET
/hris/organization-structures/teams/{team_id}/custom-fields
Retrieve custom fields for organization
get-team-custom-fields 4 params → 200400401403404500
PATCH
/hris/organization-structures/teams/{team_id}/custom-fields
Update organization structure team custom fields
update-team-custom-fields 2 params body → 200400401403404500
PUT
/people/{id}/department
Update organization structure
update-person-department 3 params body → 200400401403404500
DELETE
/hris/organization_structures/{hris_org_structure_id}
Delete an Org Structure from the Organization
delete-an-org-structure-from-the-organization-v-2026-01-01 2 params → 200400401403404500
GET
/hris/organization_structures/{hris_org_structure_id}
Fetch an Org Structure from the Organization
fetch-an-org-structure-from-the-organization-v-2026-01-01 2 params → 200400401403404500
PATCH
/hris/organization_structures/{hris_org_structure_id}
Update an existing HRIS Org Structure
update-an-existing-hris-org-structure-v-2026-01-01 2 params body → 200400401403404500

Schemas 56

The contract defines 56 schemas that model the data the API accepts and returns. The most detailed are HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItems (14 properties), HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsPendingChange (12 properties), HrisOrganizationStructuresGetResponsesContentApplicationJsonSchemaDataItems (10 properties), HrisOrganizationStructuresExternalExternalIdGetResponsesContentApplicationJsonSchemaData (9 properties). Each schema is shown below with its type and property counts.

RetrieveCustomFieldsForOrganizationRequestBadRequestError
object
1 property 1 required
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsPendingChangeStatus
string
Status of the change request
organization-structure_updatePersonDepartment_Response_200
object
1 property 1 required
HrisOrganizationStructuresPostRequestBodyContentApplicationJsonSchemaDataTeamsItems
object
2 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsType
string
Type of the custom field
organization-structure_getOrganizationStructureByExternalId_Response_200
object
1 property
HrisOrganizationStructuresExternalExternalIdPatchRequestBodyContentApplicationJsonSchemaData
object
5 properties 1 required
HrisOrganizationStructuresTeamsTeamIdCustomFieldsPatchRequestBodyContentApplicationJsonSchemaDataCustomFieldsItems
object
4 properties 1 required
HrisOrganizationStructuresHrisOrgStructureIdPatchRequestBodyContentApplicationJsonSchemaData
object
5 properties 1 required
organization-structure_updateTeamCustomFields_Response_200
object
1 property 1 required
organization-structure_getOrganizationStructures_Response_200
object
1 property
organization-structure_getTeamCustomFields_Response_200
object
4 properties 4 required
FetchAnOrgStructureFromTheOrganization-v2026-01-01RequestNotFoundError
object
1 property 1 required
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItems
object
14 properties 9 required
PeopleIdDepartmentPutResponsesContentApplicationJsonSchemaData
object
1 property 1 required
HrisOrganizationStructuresTeamsTeamIdCustomFieldsPatchResponsesContentApplicationJsonSchemaErrorsItems
object
3 properties 2 required
DeleteAnOrgStructureFromTheOrganization-v2026-01-01RequestBadRequestError
object
1 property
HrisOrganizationStructuresExternalExternalIdGetResponsesContentApplicationJsonSchemaData
object
9 properties
HrisOrganizationStructuresExternalExternalIdGetResponsesContentApplicationJsonSchemaDataTeamsItems
object
HrisOrganizationStructuresExternalExternalIdGetResponsesContentApplicationJsonSchemaDataRolesItems
object
2 properties
HrisOrganizationStructuresHrisOrgStructureIdGetResponsesContentApplicationJsonSchemaErrorsItems
object
3 properties 2 required
HrisOrganizationStructuresPostResponsesContentApplicationJsonSchemaData
object
9 properties
UpdateAnExistingHrisOrgStructure-v2026-01-01RequestInternalServerError
object
1 property
organization-structure_updateOrganizationStructureByExternalId_Response_200
object
Empty response body
HrisOrganizationStructuresHrisOrgStructureIdGetResponsesContentApplicationJsonSchemaDataTeamsItems
object
Organization structure_fetchAnOrgStructureFromTheOrganization-v2026-01-01_Response_200
object
1 property
organization-structure_deleteOrganizationStructureByExternalId_Response_200
object
Empty response body
PeopleIdDepartmentPutRequestBodyContentApplicationJsonSchemaData
object
2 properties 1 required
HrisOrganizationStructuresGetResponsesContentApplicationJsonSchemaDataItemsTeamsItems
object
7 properties
HrisOrganizationStructuresPostRequestBodyContentApplicationJsonSchemaData
object
5 properties
Organization structure_updateAnExistingHrisOrgStructure-v2026-01-01_Response_200
object
Empty response body
Organization structure_deleteAnOrgStructureFromTheOrganization-v2026-01-01_Response_200
object
Empty response body
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsPendingChangeHrisCustomFieldValueIdsItems
object
3 properties
HrisOrganizationStructuresExternalExternalIdPatchRequestBodyContentApplicationJsonSchemaDataTeamsItems
object
HrisOrganizationStructuresHrisOrgStructureIdDeleteResponsesContentApplicationJsonSchemaErrorsItems
object
2 properties
ApiError
object
2 properties
DeleteAnOrgStructureFromTheOrganization-v2026-01-01RequestInternalServerError
object
1 property
HrisOrganizationStructuresGetResponsesContentApplicationJsonSchemaDataItemsRolesItems
object
2 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsInheritedFrom
object
Parent team from which the value is inherited. Null if not inherited.
2 properties 2 required
UpdateOrganizationStructureTeamCustomFieldsRequestBadRequestError
object
1 property 1 required
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaDataItemsPendingChange
object
Pending change request information (only included if user has 'datachangerequest.view' permission)
12 properties 5 required
ApiErrorContainer
object
2 properties
organization-structure_createOrganizationStructure_Response_200
object
1 property
HrisOrganizationStructuresHrisOrgStructureIdPatchRequestBodyContentApplicationJsonSchemaDataTeamsItems
object
HrisOrganizationStructuresGetResponsesContentApplicationJsonSchemaDataItems
object
10 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsPatchRequestBodyContentApplicationJsonSchemaDataEditReason
object
Optional reason for the modification
3 properties
UpdateAnExistingHrisOrgStructure-v2026-01-01RequestBadRequestError
object
1 property
HrisOrganizationStructuresHrisOrgStructureIdGetResponsesContentApplicationJsonSchemaData
object
9 properties
HrisOrganizationStructuresHrisOrgStructureIdGetResponsesContentApplicationJsonSchemaDataRolesItems
object
2 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsGetResponsesContentApplicationJsonSchemaErrorsItems
object
3 properties 2 required
HrisOrganizationStructuresGetResponsesContentApplicationJsonSchemaDataItemsTeamsItemsChildrenItems
object
FetchAnOrgStructureFromTheOrganization-v2026-01-01RequestBadRequestError
object
1 property 1 required
HrisOrganizationStructuresHrisOrgStructureIdPatchResponsesContentApplicationJsonSchemaErrorsItems
object
2 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsPatchResponsesContentApplicationJsonSchemaData
object
3 properties 3 required
ApiErrorRequest
object
7 properties
HrisOrganizationStructuresTeamsTeamIdCustomFieldsPatchRequestBodyContentApplicationJsonSchemaData
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

deel-subpackage-organizationstructure-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_organizationStructure 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.