Developer Preview
APIs in Developer Preview are subject to change and are not intended for use in production.
Send us your suggestions for improving this API. Your feedback is valuable to us.


The Workflows API is used to manage your site's workflows.

A workflow consists of a number of phases, also known as steps. The final phase in the workflow, the phase that indicates the workflow has been completed, is known as the win phase. Each phase can contain cards that move between the phases, indicating the card's progression through the workflow.

Note: Each workflow is limited to 5,000 cards. To avoid hitting this limit, archive cards when they're no longer needed.

Retrieving IDs

When working with the Workflows API, you will often need to specify the ID of a workflow, phase, or card.

You can retrieve these IDs using the following functions:

Sometimes, you need to use more than one of these functions to retrieve the ID you need. For example, if you are looking to retrieve a specific card's ID using the listCards() function, you need to at least provide a workflow ID. So, you call listWorkflows() to retrieve the workflow ID and then pass that ID to listCards() to get the card ID.

Note that IDs for workflows, phases, and cards are also returned when they are created using the createWorkflow(), createPhase(), and createCard() functions. You can store these returned IDs and use them later.

Was this helpful?