GET/directory/positions/external-keys

Gets a list of position external keys.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

directory
directory.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/directory/positions/external-keys

Query Parameters

ParameterTypeDescription
domainId integer 

Domain ID


example : 10000001
format : int32 
count integer 

Number of items to get


default : 100
minimum : 1
maximum : 100
example : 100
format : int32 
cursor string 

Cursor


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 
hasExternalKey boolean 

Gets resources based on whether they have external keys.

  • true: Gets the resources which have external keys.
  • false: Gets the resources which do not have external keys.
  • If not specified, it gets all resources.

example : false 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
positions array (DomainUniqueExternalKeyResponse) 

Position information

 
responseMetaData object (responseMetaData) 

Response metadata

 

DomainUniqueExternalKeyResponse

PropertyTypeDescription
domainId integer 

Domain ID


format : int32
readOnly : true 
name string 

First name


readOnly : true 
id string 

ID.

It is the ID automatically assigned to a resource.


readOnly : true 
externalKey string 

Customer's external key.


readOnly : true 

responseMetaData

PropertyTypeDescription
nextCursor string 

Cursor value for pagination

 

Response Example

example

1{2  "positions": [3    {4      "domainId": 10000001,5      "name": "name01",6      "id": "position-bba1-4d6f-8397-511f673467ec",7      "externalKey": "POSITION_EXT_01"8    },9    {10      "domainId": 10000001,11      "name": "name02",12      "id": "position-7027-4a02-b838-6f52b5e38db7",13      "externalKey": "POSITION_EXT_02"14    }15  ],16  "responseMetaData": {17    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="18  }19}