API Documentation
Projects ¶
Projects ¶
For more details on how to work with custom fields please refer to Working with custom fields guide.
Note: For archived projects, only the
name
andproject_manager_id
attributes can be updated. All other attributes will be ignored during update operations.
Supported filter params
-
id
-
project_type (1: internal, 2: client)
-
company_id (array)
-
responsible_id (array)
-
person_id (array)
-
status (1: active, 2: archived)
-
query
Filter operations are supported on this endpoint.
GET /api/v2/projects
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "788",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:20.000+02:00",
"time_on_tasks": true,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:20.913+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "992"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
{
"id": "790",
"type": "projects",
"attributes": {
"name": "test project",
"number": "3",
"preferences": {},
"project_number": "3",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:21.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:21.012+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "992"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
{
"id": "791",
"type": "projects",
"attributes": {
"name": "test project",
"number": "4",
"preferences": {},
"project_number": "4",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:21.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:21.035+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "992"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/projects?page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/projects?page%5Bnumber%5D=1&page%5Bsize%5D=30"
},
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 3,
"page_size": 30,
"max_page_size": 200
}
}
Get projectsGET/api/v2/projects
GET /api/v2/projects/796
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "796",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:21.000+02:00",
"time_on_tasks": true,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:21.515+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "994"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "test name",
"project_type_id": 2
},
"relationships": {
"company": {
"data": {
"type": "companies",
"id": "2603"
}
},
"project_manager": {
"data": {
"type": "people",
"id": "3520"
}
},
"workflow": {
"data": {
"type": "workflows",
"id": "890"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "798",
"type": "projects",
"attributes": {
"name": "test name",
"number": "2",
"preferences": null,
"project_number": "2",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:21.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:21.630+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": {},
"page_custom_fields_ids": null,
"page_custom_fields_positions": {},
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "995"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": ""
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "attribute is invalid",
"source": {
"pointer": "data/attributes/workflow"
}
}
]
}
Create a projectPOST/api/v2/projects
- name
string
(required) Example: Namename
- project_manager_id
number
(required) Example: 1project manager id
- company_id
number
(required) Example: 1company id
- workflow_id
number
(required) Example: 1worfklow id
PATCH /api/v2/projects/803
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "new name"
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "803",
"type": "projects",
"attributes": {
"name": "new name",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:22.000+02:00",
"time_on_tasks": true,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:22.003+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": {},
"page_custom_fields_ids": null,
"page_custom_fields_positions": {},
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1000"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/projects/804
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "new name",
"project_manager_id": 3527,
"project_type_id": 2,
"project_color_id": 2
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "804",
"type": "projects",
"attributes": {
"name": "new name",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 1,
"project_color_id": 1,
"last_activity_at": "2025-09-03T06:07:22.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": "2025-09-03T06:07:22.000+02:00",
"created_at": "2025-09-03T06:07:22.082+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": {},
"page_custom_fields_ids": null,
"page_custom_fields_positions": {},
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1001"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/projects/807
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": ""
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/name"
}
}
]
}
PATCH /api/v2/projects/808
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"workflow_id": 905
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "808",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:22.000+02:00",
"time_on_tasks": true,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:22.672+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": {},
"page_custom_fields_ids": null,
"page_custom_fields_positions": {},
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1004"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/projects/809/archive
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "809",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:22.000+02:00",
"time_on_tasks": true,
"tag_colors": {},
"archived_at": "2025-09-03T06:07:22.000+02:00",
"created_at": "2025-09-03T06:07:22.760+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1005"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
Archives a projectPATCH/api/v2/projects/{id}/archive
- id
number
(required) Example: 1project id
PATCH /api/v2/projects/810/restore
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "810",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:22.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:22.837+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1006"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
Restores a projectPATCH/api/v2/projects/{id}/restore
- id
number
(required) Example: 1project id
DELETE /api/v2/projects/811
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "This is a name",
"template_id": 812,
"company_id": 2633,
"project_type_id": 2,
"copy_memberships": true,
"copy_boards": true,
"copy_task_lists": true,
"copy_open_tasks": true,
"copy_closed_tasks": false,
"copy_task_comments": false,
"copy_task_subscribers": false,
"copy_assignees": false,
"copy_tags": false,
"copy_estimate": true,
"copy_views": true
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "813",
"type": "projects",
"attributes": {
"name": "This is a name",
"number": "2",
"preferences": {},
"project_number": "2",
"project_color_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1008"
}
},
"company": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "This is a name",
"description": "This is a description",
"template_id": 815,
"company_id": 2636,
"project_type_id": 2,
"copy_memberships": true,
"copy_boards": true,
"copy_task_lists": true,
"copy_open_tasks": true,
"copy_task_comments": false,
"copy_task_subscribers": false,
"copy_assignees": false,
"copy_tags": false,
"copy_estimate": true,
"copy_views": true,
"copy_as_template": true
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "816",
"type": "projects",
"attributes": {
"name": "This is a name",
"number": null,
"preferences": {},
"project_number": null,
"project_color_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1009"
}
},
"company": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "This is a name",
"template_id": 819,
"company_id": 2640,
"project_type_id": 2,
"copy_memberships": true,
"copy_boards": true,
"copy_task_lists": true,
"copy_open_tasks": true,
"copy_task_comments": false,
"copy_task_subscribers": false,
"copy_assignees": false,
"copy_tags": false,
"copy_estimate": true,
"copy_views": true,
"copy_as_template": false
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "820",
"type": "projects",
"attributes": {
"name": "This is a name",
"number": "4",
"preferences": {},
"project_number": "4",
"project_color_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1010"
}
},
"company": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "This is a name",
"template_id": 821,
"project_type_id": 1,
"copy_deals": true
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "822",
"type": "projects",
"attributes": {
"name": "This is a name",
"number": "2",
"preferences": {},
"project_number": "2",
"project_color_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1011"
}
},
"company": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"name": "This is a name",
"template_id": 823,
"project_type_id": 1,
"copy_deals": true
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "824",
"type": "projects",
"attributes": {
"name": "This is a name",
"number": "2",
"preferences": {},
"project_number": "2",
"project_color_id": null
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1012"
}
},
"company": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
POST /api/v2/projects/copy
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/name"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/template"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/project_type_id"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "is not included in the list",
"source": {
"pointer": "data/attributes/project_type_id"
}
}
]
}
Copies a projectPOST/api/v2/projects/copy
PATCH /api/v2/projects/838/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"1032": 1036,
"1033": 1037,
"1034": 1036
}
},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "932"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "838",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:24.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:24.630+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1015"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/projects/849/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {}
},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "955"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/map"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "must have 2 (including one closed) or more workflow statuses defined",
"source": {
"pointer": "data/attributes/workflow"
}
},
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "doesn't contain all statuses from current project workflow",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
PATCH /api/v2/projects/860/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"1065": 1069,
"1066": 1070,
"1067": 1069
}
},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "0"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "attribute is invalid",
"source": {
"pointer": "data/attributes/workflow"
}
}
]
}
PATCH /api/v2/projects/871/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "969"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
PATCH /api/v2/projects/882/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"1097": 1101,
"1098": 1102
}
},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "981"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "doesn't contain all statuses from current project workflow",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
PATCH /api/v2/projects/893/change_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"1113": 1117,
"1114": "0",
"1115": 1117
}
},
"relationships": {
"workflow": {
"data": {
"type": "workflows",
"id": "993"
}
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "contains invalid statuses",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
Changes workflow on projectPATCH/api/v2/projects/change_workflow
- workflow_id
number
(required) Example: 1workflow id
- map
json
(required) Example: %7B+1%3A+5%2C+2%3A+6+%7Dmapping from current workflow statuses to new workflow statuses
PATCH /api/v2/projects/909/map_to_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"136": 1141,
"137": 1142,
"138": 1140
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "909",
"type": "projects",
"attributes": {
"name": "test project",
"number": "1",
"preferences": {},
"project_number": "1",
"project_type_id": 2,
"project_color_id": null,
"last_activity_at": "2025-09-03T06:07:30.000+02:00",
"time_on_tasks": false,
"tag_colors": {},
"archived_at": null,
"created_at": "2025-09-03T06:07:30.036+02:00",
"template": false,
"duplication_status": "idle",
"custom_fields": null,
"task_custom_fields_ids": null,
"task_custom_fields_positions": null,
"page_custom_fields_ids": null,
"page_custom_fields_positions": null,
"sample_data": false
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "1022"
}
},
"company": {
"meta": {
"included": false
}
},
"project_manager": {
"meta": {
"included": false
}
},
"last_actor": {
"meta": {
"included": false
}
},
"workflow": {
"meta": {
"included": false
}
},
"custom_field_people": {
"meta": {
"included": false
}
},
"custom_field_attachments": {
"meta": {
"included": false
}
},
"template_object": {
"meta": {
"included": false
}
}
}
},
"meta": {}
}
PATCH /api/v2/projects/913/map_to_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "can't be blank",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
PATCH /api/v2/projects/917/map_to_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"0": 1156,
"142": 1155
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "contains invalid task_list_id",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
PATCH /api/v2/projects/921/map_to_workflow
Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
"data": {
"type": "projects",
"attributes": {
"map": {
"145": 1166,
"146": "0"
}
}
}
}
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"errors": [
{
"status": "422",
"code": "invalid_attribute",
"title": "Invalid Attribute",
"detail": "contains invalid statuses",
"source": {
"pointer": "data/attributes/map"
}
}
]
}
Change workflow on project and map task lists to workflow statuses on project tasksPATCH/api/v2/projects/map_to_workflow
- workflow_id
number
(required) Example: 1workflow id
- map
json
(required) Example: %7B1%3A+5%2C+2%3A+6%7Dmapping from task lists to workflow statuses
Generated by aglio on 03 Sep 2025