Tasks
Tasks are work instances within a workflow
Required parameters:
  • Organization ID. Visible in Settings.
  • Queue ID. Found in the URL when inside a queue.

The task object

A task is defined by the following properties:
  • id - A unique task identifier.
  • status - The task's status, which can be new, open, in_progress or completed.
  • completed_at. ISO 8601 formatted timestamp.
  • created_at. ISO 8601 formatted timestamp.
  • completed_by. The user's email address.
  • queue. The queue name.
  • queue_id. A unique identifier for the queue the task belongs to.
  • data. A dictionary with all the attributes that characterize the queue, according to its user defined configuration. Each key nested in the object takes the name of each block's identifier. See Blocks to learn more.
  • source. The name of the source that originated the task. Can take api , zapier, manual or $filename.csv as its value.
An example task would look like this:
1
{
2
"id": 169578,
3
"status": "completed",
4
"completed_at": "2020-10-08T12:56:04.206Z",
5
"created_at": "2020-10-08T12:55:08.546Z",
6
"completed_by": "[email protected]",
7
"queue": "Sample Workflow Name",
8
"queue_id": 79,
9
"data": {
10
"comment": "A random benign comment that needs to get approved"
11
"approve": true
12
},
13
"source": "api"
14
}
Copied!
post
https://api.humanlambdas.com
/orgs/$ORGANIZATION_ID/queues/$QUEUE_ID/tasks/create
Create a task
Sample request:
1
curl -v https://api.humanlambdas.com/orgs/$ORGANIZATION_ID/queues/$QUEUE_ID/tasks/create \
2
-H "Content-Type: application/json" \
3
-H "Authorization: Token $API_KEY" \
4
-d '{"data":
5
{
6
"comment": "This is some random text"
7
}
8
}'
Copied!
get
https://api.humanlambdas.com
/orgs/$ORGANIZATION_ID/queues/$QUEUE_ID/tasks/completed
List a queue's completed tasks
Last modified 8mo ago