api:models

Models

Form

Attribute Example
id
Form identifier
"id": 36120
name
Form name
"name": "Payments"
steps
Workflow steps list.
An object whose keys are step numbers, and the values are their names/span>
"steps": {
  "1": "Manager",
  "2": "Accounting",
  "4": "CEO"
}
fields
An array of form fields
"fields": [
  {
     "id": 1,
     "type": "text",
     "name": "Purpose",
     "value": "IT conference in Amsterdam"
   },
   {
     "id": 2,
     "type": "money",
     "name": "Amount",
	 "value": 10306.25
  }
]

Form registry task

Attribute Example
id
Task identifier
"id": 11610
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"create_date": "2017-08-20T12:31:14Z"
last_modified_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
close_date
Date format: YYYY-MM-DDThh:mm:ssZ
"close_date": "2017-08-23T10:20:11Z"
fields
An array of form fields
"fields": [
  {
     "id": 1,
     "type": "text",
     "name": "Purpose",
     "value": "IT conference in Amsterdam"
   },
   {
     "id": 2,
     "type": "money",
     "name": "Amount",
	 "value": 10306.25
  }
]

Task with comments

Attribute Example
id
Task identifier
"id": 11610
text
Task text
"text": "Help with printer"
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
last_modified_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
author
Task author
"author": {
  "id": 1731,
  "first_name": "Bob",
  "last_name": "Smith",
  "email": "Bob@gmail.com"
}
due_date
The task due date.
Date format: YYYY-MM-DD
"due_date": "2018-03-21"
due
The task due date with time.
Date format: YYYY-MM-DDThh:mm:ssZ
"due": "2018-03-22T03:22:15Z"
duration
The duration of the event in minutes
"duration": 120
close_date
Date format: YYYY-MM-DDThh:mm:ssZ
"close_date" : "2018-02-14T12:44:25"
list_ids
An array of list identifiers
"list_ids": [2646, 30304, 65349]
responsible
Responsible for the task
"responsible": {
  "id": 1733,
  "first_name": "John",
  "last_name": "Snow",
  "email": "John@gmail.com"
}
participants
An array of task participants
"participants": [
  {
    "id": 1733,
    "first_name": "John",
    "last_name": "Snow",
    "email": "John@gmail.com"
  }
]
attachments
An array of files attached to the tasks
"attachments": [
  {
    "id": 6647,
	"name": "contract-142.docx",
	"md5": "5EB63BBBE01EEED093CB22BB8F5ACDC3",
	"url": "https://pyrus.com/services/attachment?id=6647"
  }
]
parent_task_id
Parent task identifier.
"parent_task_id": 5444
linked_task_ids
An array of linked task identifiers.
"linked_task_ids": [12334, 44355, 72345]
comments
An array of task comments
"comments": [
  {
    "id": 13767,
    "text": "Help with printer",
    "create_date": "2017-08-17T15:32:11Z",
    "author": {
      "id": 1731,
      "first_name": "Bob",
      "last_name": "Smith",
      "email": "Bob@gmail.com"
    }
}

Task comment

Attribute Example
id
Comment id
"id": 176324
text
Comment text
"text": "this is my comment"
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"create_date": "2017-08-23T13:12:27Z"
author
Comment author
"author": {
  "id": 1731,
  "first_name": "Bob",
  "last_name": "Smith",
  "email": "Bob@gmail.com"
}
added_list_ids
An array of lists to which the task was added
"added_list_ids": [1374, 1444]
removed_list_ids
An array of lists from which the task was removed
"removed_list_ids": [1374]
reassigned_to
The person to whom the task was reassigned
"reassigned_to": {
  "id": 1733,
  "first_name": "John",
  "last_name": "Snow",
  "email": "John@gmail.com"
}
participants_added
An array of people added to the task
"participants_added": [
  {
    "id": 1733,
    "first_name": "John",
    "last_name": "Snow",
    "email": "John@gmail.com"
  },
  {
    "id": 1332,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "Jane@gmail.com"
  },
]
participants_removed
An array of people removed from the task
"participants_removed": [
  {
    "id": 1332,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "Jane@gmail.com"
  },
]
due_date
The task due date.
Date format: YYYY-MM-DD
"due_date": "2018-03-21"
due
The task due date with time.
Date format: YYYY-MM-DDThh:mm:ssZ
"due": "2018-03-22T03:22:15Z"
duration
The duration of the event in minutes
"duration": 120
attachments
An array of files attached to the comment
"attachments": [
  {
    "id": 6652,
	"name": "contract-147.docx",
	"md5": "5EB63BBBE01EEED093CB22BB8F5ACDC4",
	"url": "https://pyrus.com/services/attachment?id=6652"
  }
]
action
Action on the task.
Possible values: finished, reopened
"action": "finished"

Form task with comments

Attribute Example
id
Task identifier
"id": 11610
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
last_modified_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
author
Task author
"author": {
  "id": 1731,
  "first_name": "Bob",
  "last_name": "Smith",
  "email": "Bob@gmail.com"
}
close_date
Date format: YYYY-MM-DDThh:mm:ssZ
"close_date" : "2018-02-14T12:44:25"
form_id
Form template identifier
"form_id": 1474
approvals
An array of approval steps. Each step contains people and their choices
"approvals": [
    [
      {
        "person": {
          "id": 1733,
          "first_name": "John",
          "last_name": "Snow",
          "email": "John@gmail.com"
        },
        "approval_choice": "approved"
      }
    ],
    [
      {
        "person": {
          "id": 1731,
          "first_name": "Bob",
          "last_name": "Smith",
          "email": "Bob@gmail.com"
        },
        "approval_choice": "waiting"
      }
    ]
  ]
attachments
An array of files attached to the task
"attachments": [
  {
    "id": 6647,
	"name": "contract-142.docx",
	"md5": "5EB63BBBE01EEED093CB22BB8F5ACDC3",
	"url": "https://pyrus.com/services/attachment?id=6647"
  }
]
parent_task_id
Parent task identifier.
"parent_task_id": 5444
linked_task_ids
An array of linked task identifiers.
"linked_task_ids": [12334, 44355, 72345]
fields
An array of form fields
"fields": [
  {
     "id": 1,
     "type": "text",
     "name": "Purpose",
     "value": "IT conference in Amsterdam"
   },
   {
     "id": 2,
     "type": "money",
     "name": "Amount",
	 "value": 10306.25
  }
]
comments
An array of task comments
"comments": [
  {
    "id": 13767,
    "text": "Help with printer",
    "create_date": "2017-08-17T15:32:11Z",
    "author": {
      "id": 1731,
      "first_name": "Bob",
      "last_name": "Smith",
      "email": "Bob@gmail.com"
    }
}

Form task comment

Attribute Example
id
Comment identifier
"id": 176324
text
Comment text
"text": "this is my comment"
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"create_date": "2017-08-23T13:12:27Z"
author
Comment author
"author": {
  "id": 1731,
  "first_name": "Bob",
  "last_name": "Smith",
  "email": "Bob@gmail.com"
}
added_list_ids
An array of lists to which the task was added
"added_list_ids": [1374, 1444]
removed_list_ids
An array of lists from which the task was removed
"removed_list_ids": [1374]
approval_choice
User's approval choice
possible vaules: approved, rejected, revoked, acknowledged
"approval_choice": "approved"
changed_step
The step number to which the task was moved. Numbering starts from one
"changed_step": 2
approvals_added
An array of added approval steps. Each step is an array containing the person and the step number
"approvals_added": [[
  {
    "person": {
      "id": 1733,
      "first_name": "Bob",
      "last_name": "Smith",
      "email": "Bob@gmail.com"
	},
    "step": 1
  }
  {
    "person": {
      "id": 1732,
      "first_name": "Sarah",
      "last_name": "Parker",
      "email": "Parker@gmail.com"
	},
    "step": 1
  }
],
[
  {
    "person": {
      "id": 1731,
      "first_name": "John",
      "last_name": "Snow",
      "email": "John@gmail.com"
	},
    "step": 2
  }
]]
approvals_removed
An array of removed approval steps. Each step is an array containing the person and the step number
"approvals_removed": [[
  {
    "person": {
      "id": 1733,
      "first_name": "Bob",
      "last_name": "Smith",
      "email": "Bob@gmail.com"
	},
    "step": 1
  } 
]]
approvals_rerequested
An array of rerequested approval steps. Each step is an array containing the person and the step number
"approvals_rerequested": [[
  {
    "person": {
      "id": 1732,
      "first_name": "Sarah",
      "last_name": "Parker",
      "email": "Parker@gmail.com"
	},
    "step": 1
  }
]]
comment_as_roles
List of roles on behalf of which the task was commented
"comment_as_roles": [
  {
    "id": 288556,
    "name": "Role1"
  }
]
field_updates
An array of updated form fields
"field_updates": [
  {
     "id": 1,
     "type": "text",
     "name": "Purpose",
     "value": "IT conference in Moscow"
   }
]
due_date
The task due date.
Date format: YYYY-MM-DD
"due_date": "2018-03-21"
due
The task due date with time.
Date format: YYYY-MM-DDThh:mm:ssZ
"due": "2018-03-22T03:22:15Z"
duration
The duration of the event in minutes
"duration": 120
attachments
An array of files attached to the comment
"attachments": [
  {
    "id": 6652,
	"name": "contract-147.docx",
	"md5": "5EB63BBBE01EEED093CB22BB8F5ACDC4",
	"url": "https://pyrus.com/services/attachment?id=6652"
  }
]
action
Action on the task.
Possible values: finished, reopened
"action": "finished"

Catalog

Attribute Example
catalog_id
Catalog identifier
"catalog_id": 422
catalog_headers
An array of catalog headers.
Possible column types: workflow, text
"catalog_headers": [
  {
    "name": "City",
    "type": "text"
  }
  {
    "name": "Street",
    "type": "text"
  }
]
items
An array of catalog items
"items": [
  {
    "item_id": 1385,
    "values": [
      "Costa Mesa",
      "2130 Fulton Streen"
    ]
  },
  {
    "item_id": 1389,
    "values": [
      "Norwalk",
      "650 Davis Street"
    ]
  }
]

List of users in the organization

Attribute Example
id
Organization identifier
"id": 2181
name
Organization name
"name": "My Organization"
persons
An array of organization members
"persons": [
  {
    "id": 1733,
    "first_name": "John",
    "last_name": "Snow",
    "email": "John@gmail.com"
  }
]
persons
An array of roles in the organization
"roles": [
  {
    "id": 1733,
    "name": "Some Role",
    "member_ids": [1725, 1733]
  }
]

Task list

Attribute Example
id
Task list identifier
"id": 1352
name
Task list name
"name": "Branch offices"
children
And array of sublists
"children": [
  {
    "id": 1465,
    "name": "Moscow"
  },
  {
    "id": 3763,
    "name": "San Francisco"
  }
]

Task in list

Attribute Example
id
Task identifier
"id": 11610
create_date
Date format: YYYY-MM-DDThh:mm:ssZ
"create_date": "2017-08-20T12:31:14Z"
last_modified_date
Date format: YYYY-MM-DDThh:mm:ssZ
"last_modified_date": "2017-08-23T10:20:11Z"
close_date
Date format: YYYY-MM-DDThh:mm:ssZ
"close_date": "2017-08-23T10:20:11Z"
author
Task author
"author": {
  "id": 1731,
  "first_name": "Bob",
  "last_name": "Smith",
  "email": "Bob@gmail.com"
}
responsible
Responsible for the task
"responsible": {
  "id": 1733,
  "first_name": "John",
  "last_name": "Snow",
  "email": "John@gmail.com"
}
text
Task text
"text": "Help with printer"

Was this article helpful?

Yes, thanks! No, I have a question