Install an action

POST

/actions

Installs a catalog entry for this organization, saving its install-time config. The install gets a unique per-organization slug derived from its name. Authorization: organization administrators only (denied → 403). Returns 400 for an unknown action or a slug collision.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

actionstringRequired>=1 character

Catalog entry to install (action or slug from GET /actions/catalog).

namestringRequired1-200 characters

configmap from strings to anyOptional

Install-time configuration; shape per the manifest config.install schema.

Response

The installed action.

dataobject

$	curl -X POST https://api.cloudraker.com/actions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"action": "extract-structured",
>	"name": "Contract terms"
>	}'

1	{
2	"data": {
3	"id": "act_01J9X2K3L4M5N6O7P8Q9",
4	"slug": "contract-terms-extraction",
5	"action": "extract-structured",
6	"name": "Contract terms",
7	"config": {},
8	"created_at": "2024-06-10T12:00:00Z",
9	"updated_at": "2024-06-10T12:00:00Z"
10	}
11	}