> ## 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 Overview (Legacy)

> Core session management and automation with org-scoped access

<Warning>
  This API version is deprecated. Use [API v3](/api-reference/v3/overview) with service user authentication. See the [migration guide](/api-reference/getting-started/migration-guide) for step-by-step instructions.
</Warning>

The v1 API provides core functionality for creating and managing Devin sessions, along with supporting resources like secrets, knowledge, and playbooks.

**Base URL:** `https://api.devin.ai/v1/*`

**Authentication:** Personal or Service API Keys ([learn more](/api-reference/authentication))

## Permissions

The v1 API uses organization-scoped authentication. API keys are scoped to a specific `(org_id, user_id)` pair and provide access to resources within that organization. The v1 API does not use the full RBAC permission system - access is determined by the API key's organization scope.

For fine-grained RBAC control, use the [Organization API](/api-reference/v3/overview) instead.

## Sessions

Manage Devin sessions and interact with them:

<CardGroup cols={2}>
  <Card title="List Sessions" icon="list" href="/api-reference/v1/sessions/list-sessions">
    List all current Devin sessions for your organization
  </Card>

  <Card title="Create a Session" icon="plus" href="/api-reference/v1/sessions/create-a-new-devin-session">
    Start a new Devin session with a task description and optional parameters
  </Card>

  <Card title="Get Session Details" icon="circle-info" href="/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    Retrieve information about an existing session's status and output
  </Card>

  <Card title="Send Message" icon="message" href="/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Interact with an active session by sending messages to Devin
  </Card>

  <Card title="Upload Files" icon="upload" href="/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    Upload files for Devin to work with during sessions
  </Card>

  <Card title="Update Session Tags" icon="tags" href="/api-reference/v1/sessions/update-session-tags">
    Update the tags associated with a Devin session
  </Card>
</CardGroup>

## Secrets

Manage secrets and credentials for your organization:

<CardGroup cols={2}>
  <Card title="List Secrets" icon="key" href="/api-reference/v1/secrets/list-secrets">
    View metadata for all secrets in your organization
  </Card>

  <Card title="Delete Secret" icon="trash" href="/api-reference/v1/secrets/delete-secret">
    Permanently remove a secret from your organization
  </Card>
</CardGroup>

## Knowledge

Manage knowledge for your organization:

<CardGroup cols={2}>
  <Card title="List Knowledge" icon="list" href="/api-reference/v1/knowledge/list-knowledge">
    List all knowledge and folders in your organization
  </Card>

  <Card title="Create Knowledge" icon="plus" href="/api-reference/v1/knowledge/create-knowledge">
    Create a new piece of knowledge
  </Card>

  <Card title="Update Knowledge" icon="pencil" href="/api-reference/v1/knowledge/update-knowledge">
    Update a piece of knowledge
  </Card>

  <Card title="Delete Knowledge" icon="trash" href="/api-reference/v1/knowledge/delete-knowledge">
    Delete a piece of knowledge
  </Card>
</CardGroup>

## Playbooks

Manage reusable instruction sets for your organization:

<CardGroup cols={2}>
  <Card title="List Playbooks" icon="list" href="/api-reference/v1/playbooks/list-playbooks">
    View all playbooks accessible to your organization
  </Card>

  <Card title="Create Playbook" icon="plus" href="/api-reference/v1/playbooks/create-playbook">
    Create a new team playbook with instructions and optional macro
  </Card>

  <Card title="Get Playbook" icon="circle-info" href="/api-reference/v1/playbooks/get-playbook">
    Retrieve details of a specific playbook
  </Card>

  <Card title="Update Playbook" icon="pencil" href="/api-reference/v1/playbooks/update-playbook">
    Update an existing team playbook
  </Card>

  <Card title="Delete Playbook" icon="trash" href="/api-reference/v1/playbooks/delete-playbook">
    Delete a team playbook from your organization
  </Card>
</CardGroup>

## Next steps

Migrate to the [current API](/api-reference/overview) for RBAC, session attribution, and new features. See the [migration guide](/api-reference/getting-started/migration-guide).


Built with [Mintlify](https://mintlify.com).