# 自动化 API (/docs/api/native/automation)





管理动作、发布脚本与工作流、查看运行并接收入站 webhook。

`https://api.deepraxis.ai/automation/v1`

## 鉴权 [#鉴权]

使用 `Authorization: Bearer $PRAXIS_API_KEY`。入站 webhook 使用创建或轮换时返回的 secret URL，无需 API Key。

## TypeScript SDK [#typescript-sdk]

SDK 尚未发布到 npm。从本地源码安装，再用 Bun 运行示例；将命令中的路径替换为本地 SDK 目录。

```bash
bun add /absolute/path/to/packages/sdk/typescript
bun example.ts
```

示例使用 develop。curl 请求体带变量时需安装 jq。资源示例名称以 `sample-` 开头；创建前换成尚未占用的名称。动作、脚本和工作流使用 `docs-samples` 命名空间，完成后归档；触发器完成后删除。

## 动作 [#动作]

- [列出动作](/docs/api/native/automation/listActions)
- [创建动作](/docs/api/native/automation/createAction)
- [读取动作](/docs/api/native/automation/getAction)
- [更新动作](/docs/api/native/automation/updateAction)
- [列出动作修订](/docs/api/native/automation/listActionRevisions)
- [读取动作修订](/docs/api/native/automation/getActionRevision)
- [回滚动作](/docs/api/native/automation/rollbackAction)
- [列出动作调用](/docs/api/native/automation/listActionInvocations)
- [列出动作引用方](/docs/api/native/automation/listActionDependents)
- [归档动作](/docs/api/native/automation/archiveAction)
- [恢复动作](/docs/api/native/automation/restoreAction)

## 脚本 [#脚本]

- [列出脚本](/docs/api/native/automation/listScripts)
- [创建脚本](/docs/api/native/automation/createScript)
- [读取脚本](/docs/api/native/automation/getScript)
- [更新脚本草稿](/docs/api/native/automation/updateScript)
- [归档脚本](/docs/api/native/automation/archiveScript)
- [恢复脚本](/docs/api/native/automation/restoreScript)
- [发布脚本版本](/docs/api/native/automation/publishScriptVersion)
- [列出脚本版本](/docs/api/native/automation/listScriptVersions)
- [读取脚本版本](/docs/api/native/automation/getScriptVersion)
- [弃用脚本版本](/docs/api/native/automation/deprecateScriptVersion)
- [列出脚本标签](/docs/api/native/automation/listScriptTags)
- [设置脚本标签](/docs/api/native/automation/setScriptTag)
- [删除脚本标签](/docs/api/native/automation/deleteScriptTag)

## 工作流 [#工作流]

- [列出工作流](/docs/api/native/automation/listWorkflows)
- [创建工作流](/docs/api/native/automation/createWorkflow)
- [读取工作流](/docs/api/native/automation/getWorkflow)
- [更新工作流草稿](/docs/api/native/automation/updateWorkflow)
- [归档工作流](/docs/api/native/automation/archiveWorkflow)
- [恢复工作流](/docs/api/native/automation/restoreWorkflow)
- [发布工作流版本](/docs/api/native/automation/publishWorkflowVersion)
- [列出工作流版本](/docs/api/native/automation/listWorkflowVersions)
- [读取工作流版本](/docs/api/native/automation/getWorkflowVersion)
- [弃用工作流版本](/docs/api/native/automation/deprecateWorkflowVersion)
- [列出工作流标签](/docs/api/native/automation/listWorkflowTags)
- [设置工作流标签](/docs/api/native/automation/setWorkflowTag)
- [删除工作流标签](/docs/api/native/automation/deleteWorkflowTag)

## 定义工具 [#定义工具]

- [校验定义](/docs/api/native/automation/validateDefinition)
- [解析运行目标](/docs/api/native/automation/resolveTarget)
- [搜索自动化定义](/docs/api/native/automation/searchTargets)

## 运行 [#运行]

- [创建运行](/docs/api/native/automation/createRun)
- [列出运行](/docs/api/native/automation/listRuns)
- [读取运行](/docs/api/native/automation/getRun)
- [取消运行](/docs/api/native/automation/cancelRun)
- [重新运行](/docs/api/native/automation/rerunRun)
- [暂停运行](/docs/api/native/automation/suspendRun)
- [恢复运行](/docs/api/native/automation/resumeRun)
- [列出等待点](/docs/api/native/automation/listRunWaits)
- [列出运行调用](/docs/api/native/automation/listRunCalls)
- [列出运行产物](/docs/api/native/automation/listRunArtifacts)
- [完成等待点](/docs/api/native/automation/completeRunWait)
- [列出运行步骤](/docs/api/native/automation/listRunTasks)
- [读取运行事件](/docs/api/native/automation/listRunEvents)
- [读取运行日志](/docs/api/native/automation/listRunLogs)
- [读取运行源码](/docs/api/native/automation/getRunSource)

## 触发器与入站 webhook [#触发器与入站-webhook]

- [列出触发器](/docs/api/native/automation/listTriggers)
- [创建触发器](/docs/api/native/automation/createTrigger)
- [读取触发器](/docs/api/native/automation/getTrigger)
- [更新触发器](/docs/api/native/automation/updateTrigger)
- [删除触发器](/docs/api/native/automation/deleteTrigger)
- [暂停触发器](/docs/api/native/automation/pauseTrigger)
- [恢复触发器](/docs/api/native/automation/resumeTrigger)
- [立即触发](/docs/api/native/automation/fireTrigger)
- [轮换回调地址](/docs/api/native/automation/rotateTriggerWebhook)
- [列出触发历史](/docs/api/native/automation/listTriggerFirings)
- [预览触发时间](/docs/api/native/automation/previewTriggerSchedule)
- [接收入站回调](/docs/api/native/automation/receiveWebhook)