# Actions

Actions are the individual, atomic operations that can be composed into
[Workflows](#tag/Workflows). Each action represents a discrete capability of the
platform — for example, "ingest document from channel", "run media transform",
"apply metadata schema", "send notification", or "publish to destination".

These endpoints are read-only discovery endpoints:
- `list` — enumerate all available actions in the platform; filter by category or type
  to find actions relevant to a specific workflow step
- `retrieve` — fetch the full definition of a specific action, including its input
  parameters, output shape, and configuration requirements

Use the Actions API to programmatically build or validate workflow definitions without
relying on hardcoded action identifiers.


## List available actions

 - [POST /api/v1/action/list](https://api.tenovos.com/openapi/content-intelligence/actions/tenovos.action.actionservice.list.md): Lists the available action definitions that can be used as steps within a workflow. Use this to discover which operations are available and what inputs each requires before building or validating a workflow.

Request:
type             - Optional filter by action role: ACTION (a standard executable step), TRIGGER (an event that starts a workflow), or CONDITION_ACTION (a conditional branch step).
inputEntities   - Optional filter by the data types the action consumes (e.g. ASSET, DOCUMENT, CONTENT). When provided, only actions compatible with all specified types are returned.

Response:
items            - List of available actions including each action's ID, name, group, description, role type, and the input and output entity types it works with. Full parameter schemas are available via the retrieve endpoint.

## Get an action

 - [POST /api/v1/action/retrieve](https://api.tenovos.com/openapi/content-intelligence/actions/tenovos.action.actionservice.retrieve.md): Retrieves full action definitions by their IDs, including complete input and output schemas.

Request:
ids        - List of action IDs to retrieve.

Response:
items      - The fully hydrated Action objects, each including the complete inputSchema,
outputSchema, configurationSchema, type, group, description, and entity mappings.