Skip to content

Latest commit

 

History

History
83 lines (72 loc) · 3.58 KB

departments.md

File metadata and controls

83 lines (72 loc) · 3.58 KB

Departments

Get all departments

Returns all departments of an enterprise associated with the connector integration. Note this operation uses Pagination and supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/departments/getAll

{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "EnterpriseIds": [
        "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "4d0201db-36f5-428b-8d11-4f0a65e960cc"
    ],
    "DepartmentIds": [
        "98776d06-60e4-495f-82f1-95ab2f644d63",
        "915fbb82-de35-48a0-9e9b-f4a7eac711bb"
    ],
    "UpdatedUtc": {
        "StartUtc": "2023-10-01T00:00:00Z",
        "EndUtc": "2023-10-31T00:00:00Z"
    },
    "Limitation": { "Count": 10 }
}
Property Type Contract Description
ClientToken string required Token identifying the client application.
AccessToken string required Access token of the client application.
Client string required Name and version of the client application.
EnterpriseIds array of string optional, max 1000 items Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token.
DepartmentIds array of string optional, max 1000 items Unique identifiers of Department.
UpdatedUtc Time interval optional, max length 3 months Interval in which Department was updated.
Limitation Limitation required Limitation on the quantity of data returned.

Response

{
    "Departments": [
        {
            "Id": "98776d06-60e4-495f-82f1-95ab2f644d63",
            "EnterpriseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "IsActive": true,
            "Name": "Sales",
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        },
        {
            "Id": "915fbb82-de35-48a0-9e9b-f4a7eac711bb",
            "EnterpriseId": "4d0201db-36f5-428b-8d11-4f0a65e960cc",
            "IsActive": true,
            "Name": "Housekeeping",
            "CreatedUtc": "2023-10-01T11:48:57Z",
            "UpdatedUtc": "2023-10-28T11:48:57Z"
        }
    ],
    "Cursor": "915fbb82-de35-48a0-9e9b-f4a7eac711bb"
}
Property Type Contract Description
Departments array of Department required The departments of the enterprise.
Cursor string optional Unique identifier of the item one newer in time order than the items to be returned. If Cursor is not specified, i.e. null, then the latest or most recent items will be returned.

Department

Property Type Contract Description
Id string required Unique identifier of the department.
EnterpriseId string required Unique identifier of the Enterprise.
IsActive boolean required Whether the department is still active.
Name string required Name of the department.
CreatedUtc string required Creation date and time of the department in UTC timezone in ISO 8601 format.
UpdatedUtc string required Last update date and time of the department in UTC timezone in ISO 8601 format.