API Documentation

API Endpoint

Workflows

Workflows

The Workflow object enables organizing tasks into distinct phases or stages, each with its own set of statuses.

This allows tracking the progress of tasks from initiation to completion.

You can learn more about Workflows in our Help documentation: Workflows

Supported filter params

  • name

  • archived (‘true’ or ‘false’)

Supported sort params

  • name
GET /api/v2/workflows
Requestsreturns workflows

GET  /api/v2/workflows

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
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": [
    {
      "id": "2177",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2237"
          }
        },
        "workflow_statuses": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2178",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2237"
          }
        },
        "workflow_statuses": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "id": "2179",
      "type": "workflows",
      "attributes": {
        "name": "Simple workflow",
        "archived_at": null
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "2237"
          }
        },
        "workflow_statuses": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "links": {
    "first": "http://api-test.productive.io/api/v2/workflows?page%5Bnumber%5D=1&page%5Bsize%5D=30",
    "last": "http://api-test.productive.io/api/v2/workflows?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 workflows
GET/api/v2/workflows

GET /api/v2/workflows/1
Requestsreturns workflow

GET  /api/v2/workflows/2180

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
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2180",
    "type": "workflows",
    "attributes": {
      "name": "Simple workflow",
      "archived_at": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2238"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Gets a workflow
GET/api/v2/workflows/{id}

URI Parameters
HideShow
id
number (required) Example: 1

workflow id

POST /api/v2/workflows
Requestscreates workflowreturns PlanLimitExceeded errorreturns error

POST  /api/v2/workflows

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": "workflows",
    "attributes": {
      "name": "Complex workflow"
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2182",
    "type": "workflows",
    "attributes": {
      "name": "Complex workflow",
      "archived_at": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2239"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/workflows

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": "workflows",
    "attributes": {
      "name": "Complex workflow"
    }
  }
}
Responses403
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "403",
      "code": "plan_limit_exceeded",
      "title": "Access Denied",
      "detail": "Plan limit exceeded",
      "source": {}
    }
  ]
}

POST  /api/v2/workflows

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
{
  "type": "workflows",
  "attributes": {
    "name": ""
  }
}
Responses422
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"
      }
    }
  ]
}

Create an workflow
POST/api/v2/workflows

URI Parameters
HideShow
name
string (required) Example: Name

name

PATCH /api/v2/workflows/1
Requestsupdates workflowreturns error

PATCH  /api/v2/workflows/2187

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": "workflows",
    "attributes": {
      "name": "Not so simple workflow"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2187",
    "type": "workflows",
    "attributes": {
      "name": "Not so simple workflow",
      "archived_at": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2242"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/workflows/2188

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": "workflows",
    "attributes": {
      "name": ""
    }
  }
}
Responses422
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"
      }
    }
  ]
}

Update an workflow
PATCH/api/v2/workflows/{id}

URI Parameters
HideShow
id
number (required) Example: 1

workflow id

DELETE /api/v2/workflows/1
Requestsrestores workflow

DELETE  /api/v2/workflows/2189

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
Responses204
This response has no content.

Deletes a workflow
DELETE/api/v2/workflows/{id}

URI Parameters
HideShow
id
number (required) Example: 1

workflow id

PATCH /api/v2/workflows/1/archive
Requestsarchives workflowdoes not archive workflow

PATCH  /api/v2/workflows/2190/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
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2190",
    "type": "workflows",
    "attributes": {
      "name": "Simple workflow",
      "archived_at": "2025-11-01T05:19:43.000+01:00"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2245"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/workflows/2192/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
Responses409
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "409",
      "code": "record_is_last_active_workflow",
      "title": "Conflict error",
      "source": {}
    }
  ]
}

Archives a workflow
PATCH/api/v2/workflows/{id}/archive

URI Parameters
HideShow
id
number (required) Example: 1

workflow id

PATCH /api/v2/workflows/1/restore
Requestsrestores workflowrestores workflow

PATCH  /api/v2/workflows/2194/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
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2194",
    "type": "workflows",
    "attributes": {
      "name": "Simple workflow",
      "archived_at": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2247"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/workflows/2195/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
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2196",
    "type": "workflows",
    "attributes": {
      "name": "Simple workflow copy",
      "archived_at": null
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "2248"
        }
      },
      "workflow_statuses": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Restores a workflow
PATCH/api/v2/workflows/{id}/restore

URI Parameters
HideShow
id
number (required) Example: 1

workflow id

Generated by aglio on 01 Nov 2025