> ## 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](/ja/api-reference/v3/overview) を使用してください。手順については、[移行ガイド](/ja/api-reference/getting-started/migration-guide) を参照してください。
</Warning>

v1 API は、Devin セッションを作成および管理するためのコア機能に加えて、シークレット、ナレッジ、プレイブックなどの補助リソースを提供します。

**ベース URL:** `https://api.devin.ai/v1/*`

**認証:** Personal API Keys または Service API Keys ([詳細はこちら](/ja/api-reference/authentication))

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

v1 API は組織スコープの認証方式を使用します。APIキーは特定の `(org_id, user_id)` の組み合わせに紐づけられ、その組織内のリソースへのアクセス権を提供します。v1 API は完全な RBAC 権限システムは使用せず、アクセスは APIキーの組織スコープによって決まります。

より細かな RBAC 制御が必要な場合は、代わりに [Organization API](/ja/api-reference/v3/overview) を使用してください。

<div id="sessions">
  ## セッション
</div>

Devin セッションを管理し、やり取りします：

<CardGroup cols={2}>
  <Card title="セッション一覧" icon="list" href="/ja/api-reference/v1/sessions/list-sessions">
    組織内の現在の Devin セッションをすべて一覧表示します
  </Card>

  <Card title="セッションを作成" icon="plus" href="/ja/api-reference/v1/sessions/create-a-new-devin-session">
    タスクの説明と任意のパラメータを指定して新しい Devin セッションを開始します
  </Card>

  <Card title="セッション詳細を取得" icon="circle-info" href="/ja/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    既存のセッションのステータスと出力に関する情報を取得します
  </Card>

  <Card title="メッセージを送信" icon="message" href="/ja/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Devin にメッセージを送信して、アクティブなセッションとやり取りします
  </Card>

  <Card title="ファイルをアップロード" icon="upload" href="/ja/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    セッション中に Devin が扱えるようにファイルをアップロードします
  </Card>

  <Card title="セッションタグを更新" icon="tags" href="/ja/api-reference/v1/sessions/update-session-tags">
    Devin セッションに関連付けられているタグを更新します
  </Card>
</CardGroup>

<div id="secrets">
  ## シークレット
</div>

組織のシークレットや認証情報を管理します。

<CardGroup cols={2}>
  <Card title="シークレット一覧" icon="key" href="/ja/api-reference/v1/secrets/list-secrets">
    組織内のすべてのシークレットのメタデータを表示します
  </Card>

  <Card title="シークレットの削除" icon="trash" href="/ja/api-reference/v1/secrets/delete-secret">
    組織からシークレットを完全に削除します
  </Card>
</CardGroup>

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

組織の Knowledge を管理します：

<CardGroup cols={2}>
  <Card title="Knowledge を一覧表示" icon="list" href="/ja/api-reference/v1/knowledge/list-knowledge">
    組織内のすべての Knowledge とフォルダーを一覧表示します
  </Card>

  <Card title="Knowledge を作成" icon="plus" href="/ja/api-reference/v1/knowledge/create-knowledge">
    新しい Knowledge を作成します
  </Card>

  <Card title="Knowledge を更新" icon="pencil" href="/ja/api-reference/v1/knowledge/update-knowledge">
    既存の Knowledge を更新します
  </Card>

  <Card title="Knowledge を削除" icon="trash" href="/ja/api-reference/v1/knowledge/delete-knowledge">
    既存の Knowledge を削除します
  </Card>
</CardGroup>

<div id="playbooks">
  ## プレイブック
</div>

組織向けの再利用可能な手順セットを管理します。

<CardGroup cols={2}>
  <Card title="プレイブック一覧" icon="list" href="/ja/api-reference/v1/playbooks/list-playbooks">
    組織でアクセス可能なすべてのプレイブックを表示します
  </Card>

  <Card title="プレイブックを作成" icon="plus" href="/ja/api-reference/v1/playbooks/create-playbook">
    手順と任意のマクロを含む新しいチームプレイブックを作成します
  </Card>

  <Card title="プレイブックを取得" icon="circle-info" href="/ja/api-reference/v1/playbooks/get-playbook">
    特定のプレイブックの詳細を取得します
  </Card>

  <Card title="プレイブックを更新" icon="pencil" href="/ja/api-reference/v1/playbooks/update-playbook">
    既存のチームプレイブックを更新します
  </Card>

  <Card title="プレイブックを削除" icon="trash" href="/ja/api-reference/v1/playbooks/delete-playbook">
    組織からチームプレイブックを削除します
  </Card>
</CardGroup>

<div id="next-steps">
  ## 次のステップ
</div>

RBAC、セッション属性付与、新機能を利用するには、[現行の API](/ja/api-reference/overview) へ移行してください。[移行ガイド](/ja/api-reference/getting-started/migration-guide) を参照してください。