Introduction
This guide assumes that you already authenticated and defined the project ID as variable PROJ
and the project token as variable PTOKEN
. For more information, please refer to Authentication.
View workflows
Display the details of all the workflows from this project:
curl -s GET -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/projects/$PROJ/workflows/ | jq '.'
Display all the workflow IDs and their names from this project:
curl -s GET -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/projects/$PROJ/workflows | jq -r '.data[] | .id,.name'
Display the details of a specific workflow and save them in a new file (workflow_details.json
):
WORKFLOW=b7fe8da8-d9fb-4631-835e-88e4d4d2fa58
curl -L -s https://api.up42.com/projects/$PROJ/workflows/$WORKFLOW \
-H "Authorization: Bearer $PTOKEN" | jq '.' > workflow_details.json
Get the tasks of a specific workflow and save them in a new file (workflow_tasks.json
):
curl -L -s https://api.up42.com/projects/$PROJ/workflows/$WORKFLOW/tasks \
-H "Authorization: Bearer $PTOKEN" | jq '.' > workflow_tasks.json
Do not confuse workflow tasks (also defined as blocks) with job tasks (also defined as job steps that generate individual outputs).
Update workflow
The created workflow was based on the data block with the block ID defb134b-ca00-4e16-afa0-639c6dc0c5fe
. This data block is the first task of the workflow.
In this example, we will replace the first task with the data block that has the block ID 63a69b97-1765-474e-b465-0b319b8d3b2d
. Create a file containing the request body that includes all the 3 tasks you previously added. In this request body, replace the first task with the new task (workflow_with_spot.json
):
Update your workflow with the new task and save your response in a new file (workflow_updated_response.json
):
curl -s POST -H "Authorization: Bearer $PTOKEN" -H 'Content-Type: application/json' \
https://api.up42.com/projects/$PROJ/workflows/$NEW_WORKFLOW/tasks \
-d @workflow_with_spot.json \
| jq '.' > workflow_updated_response.json
Delete workflow
Delete the workflow from your project:
WORKFLOW=613052d3-e7db-4d9a-9c1f-7c8e4fd8f797
curl -sL -X DELETE https://api.up42.com/projects/$PROJ/workflows/$WORKFLOW \
-H "Authorization: Bearer $PTOKEN"
Verify that the workflow has been deleted:
curl -s -L https://api.up42.com/projects/$PROJ/workflows/$WORKFLOW \
-H "Authorization: Bearer $PTOKEN" | jq '.'