Create an action definition

POST

/actions

Creates a draft custom action definition (extract, generate, or fill). The slug is immutable and may not shadow a builtin or an existing custom action.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Request

This endpoint expects an object.

objectRequired

Response

The created definition.

definitionmap from strings to any

An arbitrary JSON object.

Errors

400

Bad Request Error

401

Unauthorized Error

1	curl -X POST https:/https://api/actions \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"kind": "generate",
6	"name": "Monthly Sales Report Generator",
7	"slug": "monthly-sales-report",
8	"generation": {
9	"template": {
10	"source": "library",
11	"templateId": "tpl-12345"
12	},
13	"cardinality": "one-per-record",
14	"output": {
15	"format": "pdf",
16	"filenameTemplate": "sales-report-{{date}}.pdf"
17	}
18	}
19	}'

1	{
2	"definition": {}
3	}