Updates a specifc action of a project automation.

PUT

https://api.awork.com/api/v1/projects/:projectId/automations/:automationId/actions/:actionId

Updates an exsting action including its values for an automation. Actions of automations created from a workflow cannot be modified. <Check title="Required Permissions" icon="key">The user must be owner of the project or must have `project-master-data:write` permissions on the specified project.</Check>

Updates an exsting action including its values for an automation. Actions of automations created from a workflow cannot be modified.

Required Permissions

The user must be owner of the project or must have project-master-data:write permissions on the specified project.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

projectIdstringRequiredformat: "uuid"

The id of the project of the automation.

automationIdstringRequiredformat: "uuid"

The id of the automation.

actionIdstringRequiredformat: "uuid"

The id of the action.

Request

The model to update an action.

typestringRequired>=1 character

The type of the action.

valueslist of objectsRequired

The values of the action.

orderdouble or nullOptional

The order of the action.

Response

idstringformat: "uuid"

The id of the action.

createdBystringformat: "uuid"

The id of the user who created the action.

createdOnstringformat: "date-time"

The date the action was created.

updatedBystringformat: "uuid"

The id of the user who updated the action.

updatedOnstringformat: "date-time"

The date the action was updated.

typestring or null

The type of the action.

orderdouble or null

The order of the action.

valueslist of objects or null

The values of the action.

Errors

400

Bad Request Error

$	curl -X PUT https://api.awork.com/api/v1/projects/projectId/automations/automationId/actions/actionId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"type": "tag-add-task",
>	"values": [
>	{
>	"name": "user",
>	"value": null
>	}
>	]
>	}'

1	{
2	"id": "123e4567-e89b-12d3-a456-426614174000",
3	"createdBy": "123e4567-e89b-12d3-a456-426614174000",
4	"createdOn": "2024-01-15T09:30:00Z",
5	"updatedBy": "123e4567-e89b-12d3-a456-426614174000",
6	"updatedOn": "2024-01-15T09:30:00Z",
7	"type": "tag-add-task",
8	"order": 2,
9	"values": [
10	{
11	"name": "tag",
12	"value": "Design"
13	}
14	]
15	}

$	curl -X PUT https://api.awork.com/api/v1/projects/projectId/automations/automationId/actions/actionId \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"type": "tag-add-task",
>	"values": [
>	{
>	"name": "user",
>	"value": null
>	}
>	]
>	}'

1	{
2	"id": "123e4567-e89b-12d3-a456-426614174000",
3	"createdBy": "123e4567-e89b-12d3-a456-426614174000",
4	"createdOn": "2024-01-15T09:30:00Z",
5	"updatedBy": "123e4567-e89b-12d3-a456-426614174000",
6	"updatedOn": "2024-01-15T09:30:00Z",
7	"type": "tag-add-task",
8	"order": 2,
9	"values": [
10	{
11	"name": "tag",
12	"value": "Design"
13	}
14	]
15	}