> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# v1 API 概览（旧版）

> 具有组织级访问控制的核心会话管理与自动化

<Warning>
  此 API 版本已弃用。请使用采用服务用户身份验证的 [API v3](/zh/api-reference/v3/overview)。请参阅[迁移指南](/zh/api-reference/getting-started/migration-guide)获取分步操作说明。
</Warning>

v1 API 提供用于创建和管理 Devin 会话的核心功能，以及 secrets、knowledge 和 playbooks 等配套资源。

**基础 URL：** `https://api.devin.ai/v1/*`

**身份验证：** 个人或服务 API Keys ([了解更多](/zh/api-reference/authentication))

<div id="permissions">
  ## 权限
</div>

v1 API 使用基于组织范围的身份验证。API key 的作用域限定在特定的 `(org_id, user_id)` 组合上，并提供对该组织内资源的访问。v1 API 不使用完整的 RBAC 权限系统——访问权限由该 API key 所属的组织范围决定。

如需更细粒度的 RBAC 控制，请使用 [Organization API](/zh/api-reference/v3/overview)。

<div id="sessions">
  ## 会话
</div>

管理 Devin 会话并与其交互：

<CardGroup cols={2}>
  <Card title="列出会话" icon="list" href="/zh/api-reference/v1/sessions/list-sessions">
    列出你所在组织当前的所有 Devin 会话
  </Card>

  <Card title="创建会话" icon="plus" href="/zh/api-reference/v1/sessions/create-a-new-devin-session">
    使用任务描述和可选参数启动新的 Devin 会话
  </Card>

  <Card title="获取会话详情" icon="circle-info" href="/zh/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    获取现有会话的状态和输出信息
  </Card>

  <Card title="发送消息" icon="message" href="/zh/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    通过向 Devin 发送消息与活动会话交互
  </Card>

  <Card title="上传文件" icon="upload" href="/zh/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    上传文件供 Devin 在会话期间使用
  </Card>

  <Card title="更新会话标签" icon="tags" href="/zh/api-reference/v1/sessions/update-session-tags">
    更新与 Devin 会话关联的标签
  </Card>
</CardGroup>

<div id="secrets">
  ## Secrets
</div>

为你的组织管理 Secrets 和凭证：

<CardGroup cols={2}>
  <Card title="列出 Secrets" icon="key" href="/zh/api-reference/v1/secrets/list-secrets">
    查看你组织中所有 Secrets 的元数据
  </Card>

  <Card title="删除 Secret" icon="trash" href="/zh/api-reference/v1/secrets/delete-secret">
    从你的组织中永久删除一个 Secret
  </Card>
</CardGroup>

<div id="knowledge">
  ## Knowledge
</div>

管理组织的 Knowledge：

<CardGroup cols={2}>
  <Card title="List Knowledge" icon="list" href="/zh/api-reference/v1/knowledge/list-knowledge">
    列出组织中的所有 Knowledge 和文件夹
  </Card>

  <Card title="Create Knowledge" icon="plus" href="/zh/api-reference/v1/knowledge/create-knowledge">
    创建一条新的 Knowledge
  </Card>

  <Card title="Update Knowledge" icon="pencil" href="/zh/api-reference/v1/knowledge/update-knowledge">
    更新一条 Knowledge
  </Card>

  <Card title="Delete Knowledge" icon="trash" href="/zh/api-reference/v1/knowledge/delete-knowledge">
    删除一条 Knowledge
  </Card>
</CardGroup>

<div id="playbooks">
  ## Playbooks
</div>

为你的组织管理可复用的指令集：

<CardGroup cols={2}>
  <Card title="列出 Playbook" icon="list" href="/zh/api-reference/v1/playbooks/list-playbooks">
    查看你的组织可访问的所有 Playbook
  </Card>

  <Card title="创建 Playbook" icon="plus" href="/zh/api-reference/v1/playbooks/create-playbook">
    创建包含指令和可选宏的新团队 Playbook
  </Card>

  <Card title="获取 Playbook" icon="circle-info" href="/zh/api-reference/v1/playbooks/get-playbook">
    获取特定 Playbook 的详细信息
  </Card>

  <Card title="更新 Playbook" icon="pencil" href="/zh/api-reference/v1/playbooks/update-playbook">
    更新现有团队 Playbook
  </Card>

  <Card title="删除 Playbook" icon="trash" href="/zh/api-reference/v1/playbooks/delete-playbook">
    从你的组织中删除团队 Playbook
  </Card>
</CardGroup>

<div id="next-steps">
  ## 后续步骤
</div>

迁移到[当前 API](/zh/api-reference/overview)，以使用 RBAC、会话归因和新功能。请参阅[迁移指南](/zh/api-reference/getting-started/migration-guide)。