Actions
For instructions on how to authenticate to use this endpoint, see API overview.
Endpoints
GET | |
POST | |
GET | |
PATCH | |
DELETE |
List all actions
Required API key scopes
action:read
Path parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- formatstringOne of:
"csv"
"json"
- limitinteger
Number of results to return per page.
- offsetinteger
The initial index from which to return the results.
Response
Example request
GET
/api /projects /:project_id /actions
Example response
Status 200
Create actions
Required API key scopes
action:write
Path parameters
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- formatstringOne of:
"csv"
"json"
Request parameters
- namestring
- descriptionstring
- tagsarray
- post_to_slackboolean
- slack_message_formatstring
- stepsarray
- deletedboolean
- last_calculated_atstring
- pinned_atstring
- _create_in_folderstring
Response
Example request
POST
/api /projects /:project_id /actions
Example response
Status 201
Retrieve actions
Required API key scopes
action:read
Path parameters
- idinteger
A unique integer value identifying this action.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- formatstringOne of:
"csv"
"json"
Response
Example request
GET
/api /projects /:project_id /actions /:id
Example response
Status 200
Update actions
Required API key scopes
action:write
Path parameters
- idinteger
A unique integer value identifying this action.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- formatstringOne of:
"csv"
"json"
Request parameters
- namestring
- descriptionstring
- tagsarray
- post_to_slackboolean
- slack_message_formatstring
- stepsarray
- deletedboolean
- last_calculated_atstring
- pinned_atstring
- _create_in_folderstring
Response
Example request
PATCH
/api /projects /:project_id /actions /:id
Example response
Status 200
Delete actions
Hard delete of this model is not allowed. Use a patch API call to set "deleted" to true
Required API key scopes
action:write
Path parameters
- idinteger
A unique integer value identifying this action.
- project_idstring
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
- formatstringOne of:
"csv"
"json"
Example request
DELETE
/api /projects /:project_id /actions /:id