> For the complete documentation index, see [llms.txt](https://docs.toolregistry.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolregistry.ai/api-documentation/actions.md).

# Actions

## List actions

> Retrieves actions for the authenticated owner

```json
{"openapi":"3.0.0","info":{"title":"toolregistry.ai API","version":"1.0"},"servers":[{"url":"https://api.toolregistry.ai"}],"security":[{}],"paths":{"/v1/actions":{"get":{"description":"Retrieves actions for the authenticated owner","operationId":"ActionsController_listActions","parameters":[],"responses":{"200":{"description":"Actions retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ListActionsResponseDto"}}}}},"401":{"description":"Unauthorized - invalid API key"}},"summary":"List actions","tags":["Actions"]}}},"components":{"schemas":{"ListActionsResponseDto":{"type":"object","properties":{"key":{"type":"string","description":"The key of the action"},"intent":{"type":"string","description":"The intent associated with the action"},"outputSchema":{"type":"object","description":"JSON Schema draft 7 schema for action output format","format":"json-schema"},"inputSchema":{"type":"object","description":"JSON Schema draft 7 schema for action input format","format":"json-schema"},"useDefaultMapping":{"type":"boolean","description":"Whether default input/output mapping is used"},"updatedAt":{"format":"date-time","type":"string","description":"Action last update timestamp"},"createdAt":{"format":"date-time","type":"string","description":"Action creation timestamp"}},"required":["key","intent","useDefaultMapping","updatedAt","createdAt"]}}}}
```

## Run an action

> Runs an action for the specified action key, customer integration ID and user ID

```json
{"openapi":"3.0.0","info":{"title":"toolregistry.ai API","version":"1.0"},"servers":[{"url":"https://api.toolregistry.ai"}],"security":[{}],"paths":{"/v1/actions/run":{"post":{"description":"Runs an action for the specified action key, customer integration ID and user ID","operationId":"ActionsController_runAction","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunActionRequest"}}}},"responses":{"200":{"description":"Action run successfully. Returns runId and output in the shape of action's output schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunActionResponse"}}}},"401":{"description":"Unauthorized - invalid API key"}},"summary":"Run an action","tags":["Actions"]}}},"components":{"schemas":{"RunActionRequest":{"type":"object","properties":{"key":{"type":"string","description":"The key of the action to run"},"userId":{"type":"string","description":"The ID of the user who is running the action"},"input":{"type":"object","description":"Input parameters for the action. Required if action has input schema defined."},"passThrough":{"description":"Pass through data for the action run, e.g. credentials for the integrations used in the run","type":"array","items":{"type":"object"}}},"required":["key","userId"]},"RunActionResponse":{"type":"object","properties":{"runId":{"type":"string","description":"The ID of the run that was created","format":"uuid"},"output":{"type":"object","description":"The output of the action"}},"required":["runId","output"]}}}}
```