Common request records

These records are reused across different API calls.

Address

Field Type JSON Type Required Can be null Description

formatted

String

String

No

No

Full address string. Limited to 5000 characters

geolocation

Geolocation

Object

No

No

Full address as one string

apartment

String

String

No

Yes

Apartment. Limited to 50 characters

floor

String

String

No

Yes

Floor. Limited to 50 characters

entrance_no

String

String

No

Yes

Entrance. Limited to 50 characters

description

String

String

Yes

Yes

Optional string description. It usually contains some information helping locating the site. Limited to 500 characters

Client

You can reference a client by uuid or external_id. These fields are mutually exclusive.

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Client identifier

external_id

String

String

No

No

Client identifier in an external system

Site

You can reference a site by uuid or external_id. These fields are mutually exclusive.

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Site identifier

external_id

String

String

No

No

Site identifier in an external system

Assignee

Job assignee is either a single worker or a team. worker and team keys are mutually exclusive.

Field Type JSON Type Required Can be null Description

worker

Record

Object

No

No

worker.uuid

UUID

String

No

No

Worker identifier

worker.email

Email

String

No

No

Emails are unique, it is possible to use them for referencing workers

team

Record

Object

No

No

team.uuid

UUID

String

No

No

Team identifier

team.name

String

String

No

No

Team names are unique

Job template

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Template identifier

Job type

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Job type identifier

Contact

Field Type JSON Type Required Can be null Description

name

String

String

No

Yes

Contact name. Limited to 50 characters

value

String

String

No

Yes

Contact string. Limited to 50 characters.
For adding multiple phone numbers add multiple contact records. Bear in mind, each contact is displayed as a separate dial button for the field worker

type

String

String

Yes

No

Only "phone" value is supported at the moment

Resolution

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Resolution identifier

name

String

String

No

No

Resolution name

Territory

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Territory identifier

name

String

String

No

No

Territory name

Skill

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Skill identifier

name

String

String

No

No

Skill name

Dictionary value

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Dictionary item identifier

name

String

String

No

No

Name of dictionary item

Custom field

To set a value of a custom field, pass either its uuid or name. You can get these values from the job template response.

Field Type JSON Type Required Can be null Description

uuid

UUID

String

No

No

Field identifier

name

String

String

No

No

Field name

value

Mixed

Mixed

Yes

No

value type depends on data_type value of the field

Table 1. value format depending on data_type
data_type JSON type of value Can be null Description

string

String

Yes

dictionary

Dictionary value

Yes

Dictionary value referenced by uuid or name

attachment

File value

Yes

File value

Field Type JSON Type Required Can be null Description

name

String

String

Yes

No

File name

base64_content

String

String

Yes

No

Base64-encoded file content