Skip to main content
GET
Get

Authorizations

Authorization
string
header
required

OAuth 2.0 client-credentials flow. Request an access token from the token endpoint and send it as Authorization: Bearer <token>.

Path Parameters

id
string
required

Global id of the department.

Response

The department.

An Oleria Department object represents a business department or organizational unit associated with employee records and organizational hierarchy in an enterprise HR system, identity provider, or directory service

id
string
required

An identifier for a Department object in the Oleria system. Oleria converts these identifiers to global ids so they can be unique in the context of the global system graph. It is important for this identifier to be based on an underlying persistent and reusable application id so connections to the object are robust to metadata changes and other relevant operations.

Example:

"A34938434"

name
string
required
Example:

"Engineering"

objectMetadata
object
required

The ObjectMetadata structure defines metadata that applies to every object and relationship, and is usually managed by the system that receives the data

globalId
string
required
oleriaObjectMetadata
object
required

object metadata supersets object metadata with platform enrichment provenance — the enrichment version and the time the record was generated

authorizedLocations
object

AuthorizedLocationPolicy is used to specify locations authorized for use by accounts, groups, roles, employees, departments, etc.

companyCode
string
Example:

"E39284"

createdDate
string<date-time>

The date the Department object was created

Example:

"2024-05-02T03:17:34.948Z"

lastModifiedDate
string<date-time>

The date the _Department object was last modified

Example:

"2024-05-02T03:17:34.948Z"

objectDirectoryContainerFederation
object

Federation information used when specifying an EntityIdentifier

objectDirectoryContainerId
string

An identifier (unique to the integrated application) for a ObjectDirectory object represented in the Oleria system. Oleria converts these identifiers to global ids so they can be unique in the context of the global system graph. It is important for this identifier to be based on an underlying persistent and reusable application or identity provider id so connections to the object are robust to metadata changes and other relevant operations

Example:

"repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)"

type
string

The type for the Department object allowing it to represent different types of organizational units (this can be used as a display name)

Example:

"Division, Business Unit"

globalAuthorizedLocations
object

AuthorizedLocationPolicy is used to specify locations authorized for use by accounts, groups, roles, employees, departments, etc.

globalObjectDirectoryContainerId
string
sorPrimaryStewardEmail
string