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.
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
createCard() functions. You can store these returned IDs and use them later.
Was this helpful?