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 Organization Structure API

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

Deel Subpackage Organization Structure API is one of 128 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.2.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.2.0
API Version
1.0.0
Base URL
https://api.letsdeel.com/rest/v2
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Deel Subpackage Organization Structure 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), HrisOrganizationStructuresPostResponsesContentApplicationJsonSchemaData (9 properties). Each schema is shown below with its type and property counts.

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

deel-com-subpackage-organizationstructure-api-openapi.yml Raw ↑

Other APIs Deel publishes across the network.

Deel Adjustments API
Deel Applications API
Deel Candidates API
Deel Contractor Amendments API
Deel Contractor Hiring API
Deel Contracts API
Deel Custom Fields API
Deel IT API
Deel EOR Amendments API
Deel EOR Benefits API
Deel EOR Cost Calculator API
Deel EOR Hiring API
Where this information came from

This is an independent, third-party profile of Deel Subpackage Organization Structure 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.