Headers
-
X-Correlation-Id string
Unique identifier to allow referencing a particular transaction or event chain
Minimum length is
1
. -
Accept-Language string
Returns the requested resources translated according to the passed languages (see translatable resources)
Minimum length is
1
.
Path parameters
-
Primary identifier of the requested resource
Minimum length is
1
.
Body
-
email string | null
Minimum length is
1
. -
externalId string | null
Minimum length is
1
, maximum length is255
. -
phoneNumber string | null
Minimum length is
1
. -
active boolean | null
-
virtual boolean | null
-
timeZone string | null
Minimum length is
1
. -
usesIndependentAgents boolean | null
-
translations object
-
location object | null
Responses
-
200 application/json
Successful operation
-
404 application/json
Resource not found
-
422 application/json
Business validation failed
LOCATION_GEOCODING_FAILED
LOCATION_TIME_ZONE_RESOLUTION_FAILED
See Error codes
PATCH /offices/{id}
curl \
-X PATCH https://api.development.pexipengage.com/enterprises/acme/offices/1234 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
-H "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002" \
-H "Accept-Language: en *" \
-d '{"email":"john.doe@pexip.com","externalId":"ABCD1234","phoneNumber":"+32412345678","active":true,"virtual":true,"timeZone":"Europe/Brussels","usesIndependentAgents":true,"translations":{"name":[{"language":"en","value":"Lorem ipsum"}],"description":[{"language":"en","value":"Lorem ipsum"}],"directions":[{"language":"en","value":"Lorem ipsum"}],"parkingInfo":[{"language":"en","value":"Lorem ipsum"}]},"location":{"postalCode":"9000","countryCode":"BE","geolocation":{"latitude":51.0479466,"longitude":3.6912248},"translations":{"city":[{"language":"en","value":"Lorem ipsum"}],"state":[{"language":"en","value":"Lorem ipsum"}],"street1":[{"language":"en","value":"Lorem ipsum"}],"street2":[{"language":"en","value":"Lorem ipsum"}]}}}'
Request example
# Headers
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002
Accept-Language: en *
# Payload
{
"email": "john.doe@pexip.com",
"externalId": "ABCD1234",
"phoneNumber": "+32412345678",
"active": true,
"virtual": true,
"timeZone": "Europe/Brussels",
"usesIndependentAgents": true,
"translations": {
"name": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"description": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"directions": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"parkingInfo": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
},
"location": {
"postalCode": "9000",
"countryCode": "BE",
"geolocation": {
"latitude": 51.0479466,
"longitude": 3.6912248
},
"translations": {
"city": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"state": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"street1": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"street2": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
}
}
}
Response examples (200)
{
"data": {
"id": "123",
"name": {
"language": "en",
"value": "Lorem ipsum"
},
"description": {
"language": "en",
"value": "Lorem ipsum"
},
"directions": {
"language": "en",
"value": "Lorem ipsum"
},
"parkingInfo": {
"language": "en",
"value": "Lorem ipsum"
},
"email": "john.doe@pexip.com",
"externalId": "ABCD1234",
"phoneNumber": "+32412345678",
"active": true,
"virtual": true,
"timeZone": "Europe/Brussels",
"usesIndependentAgents": true,
"employeeRelations": [
{
"role": "AGENT",
"employee": {
"id": "123"
}
}
],
"createdAt": "2022-08-17T19:05:21.362Z",
"updatedAt": "2022-08-17T19:05:21.362Z",
"deletedAt": "2022-08-17T19:05:21.362Z",
"location": {
"city": {
"language": "en",
"value": "Lorem ipsum"
},
"state": {
"language": "en",
"value": "Lorem ipsum"
},
"street1": {
"language": "en",
"value": "Lorem ipsum"
},
"street2": {
"language": "en",
"value": "Lorem ipsum"
},
"postalCode": "9000",
"countryCode": "BE",
"formattedAddress": "string",
"geolocation": {
"latitude": 51.0479466,
"longitude": 3.6912248
},
"translations": {
"city": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"state": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"street1": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"street2": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
}
},
"translations": {
"name": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"description": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"directions": [
{
"language": "en",
"value": "Lorem ipsum"
}
],
"parkingInfo": [
{
"language": "en",
"value": "Lorem ipsum"
}
]
}
}
}
Response examples (404)
{
"errors": [
{
"message": "string",
"code": "string",
"type": "string",
"statusCode": "string"
}
]
}
Response examples (422)
{
"errors": [
{
"message": "string",
"code": "string",
"type": "string",
"statusCode": "string",
"arguments": {}
}
]
}