Cognition Labs

Cognition Labs is the applied AI lab behind Devin, the autonomous AI software engineer that plans, writes, tests, and ships code inside its own shell, code editor, and browser. The Devin API lets teams create and drive Devin sessions programmatically - sending prompts and follow-up messages, attaching files, storing organizational knowledge and reusable playbooks, injecting secrets, and tracking Agent Compute Unit (ACU) consumption - across a legacy v1 surface, a v2 enterprise surface, and a current v3 organizations/enterprise surface built around service-user and personal access tokens.

9 APIs 0 Features
AIAI AgentAutonomous CodingSoftware EngineeringLLMDevin

APIs

Devin Sessions API

Create a Devin session with a natural-language prompt and optional playbook, snapshot, knowledge, secrets, tags, and a max ACU cap; list sessions with filters; retrieve full ses...

Devin Messages API

Send follow-up messages into a running Devin session to steer, correct, or add context to its work, and list the message history of a session. The session must be in a running s...

Devin Attachments API

Upload files (multipart/form-data) for Devin to work with, receiving back a file URL that is referenced in a session prompt as ATTACHMENT:"{file_url}", and download attachment f...

Devin Knowledge API

Create, list, update, and delete organization-level knowledge entries and folders - persistent notes with a trigger description that Devin automatically pulls into relevant sess...

Devin Playbooks API

Create, retrieve, list, update, and delete team playbooks - reusable, named instruction sets that seed new Devin sessions via a playbook_id so recurring tasks run the same way e...

Devin Secrets API

Create, list, and delete organization secrets (cookie, key-value, dictionary, or TOTP types) that Devin can use inside sessions without exposing values back over the API; list r...

Devin Organizations API

Current (v3) organization-scoped surface at /v3/organizations/{org_id} - create and manage sessions with optional user attribution, list/invite/delete organization users, and re...

Devin Enterprise API

Cross-organization administration at /v3/enterprise and the v2 enterprise surface - create, list, update, and delete organizations and their members, provision and revoke servic...

Devin Usage & Consumption API

Read enterprise- and session-level Agent Compute Unit (ACU) consumption - daily totals across an enterprise, per-organization and per-user daily consumption, and per-session usa...

Collections

Devin API (Cognition Labs)

OPEN

Pricing Plans

Cognition Labs Plans Pricing

6 plans

PLANS

Rate Limits

Cognition Labs Rate Limits

6 limits

RATE LIMITS

FinOps

Cognition Labs Finops

FINOPS

Resources

🔗
TrustCenter
TrustCenter
🔗
VulnerabilityDisclosure
VulnerabilityDisclosure
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📰
Blog
Blog

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Devin API (Cognition Labs)
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Sessions
    type: folder
  items:
  - info:
      name: Create a new Devin session.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/sessions
      body:
        type: json
        data: "{\n  \"prompt\": \"Fix the failing tests in the payments module\"\n}"
    docs: Creates a new Devin session from a natural-language prompt.
  - info:
      name: List sessions.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/sessions?limit=100&offset=0
    docs: Lists sessions for the organization, with optional filters.
  - info:
      name: Retrieve session details.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/sessions/:session_id
      params:
      - name: session_id
        value: ''
        type: path
        description: The unique identifier of the session.
    docs: Retrieves full status, message history, and structured output for a session.
  - info:
      name: Update session tags.
      type: http
    http:
      method: PUT
      url: https://api.devin.ai/v1/sessions/:session_id/tags
      params:
      - name: session_id
        value: ''
        type: path
        description: The unique identifier of the session.
      body:
        type: json
        data: "{\n  \"tags\": [\"payments\", \"bugfix\"]\n}"
    docs: Replaces the tag list on a session (maximum 50 tags).
  - info:
      name: Terminate a session.
      type: http
    http:
      method: DELETE
      url: https://api.devin.ai/v1/sessions/:session_id
      params:
      - name: session_id
        value: ''
        type: path
        description: The unique identifier of the session.
    docs: Terminates a running session.
- info:
    name: Messages
    type: folder
  items:
  - info:
      name: Send a message to a session.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/sessions/:session_id/message
      params:
      - name: session_id
        value: ''
        type: path
        description: The unique identifier of the session.
      body:
        type: json
        data: "{\n  \"message\": \"Also add a changelog entry\"\n}"
    docs: Sends a follow-up message into a running session.
- info:
    name: Attachments
    type: folder
  items:
  - info:
      name: Upload a file for Devin to work with.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/attachments
      body:
        type: form-data
        data:
        - key: file
          type: file
          value: ''
    docs: Uploads a file and returns its URL for use as ATTACHMENT:"{file_url}" in a prompt.
  - info:
      name: Download an attachment file.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/attachments/:attachment_id
      params:
      - name: attachment_id
        value: ''
        type: path
        description: The ID of the attachment.
    docs: Downloads an attachment file by ID.
- info:
    name: Knowledge
    type: folder
  items:
  - info:
      name: List all knowledge.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/knowledge
    docs: Lists all knowledge entries and folders for the organization.
  - info:
      name: Create knowledge entry.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/knowledge
      body:
        type: json
        data: "{\n  \"name\": \"Deploy process\",\n  \"body\": \"Always run migrations before deploying the API service.\"\
          ,\n  \"trigger_description\": \"When a session touches deployment scripts.\"\n}"
    docs: Creates a new knowledge entry.
  - info:
      name: Update knowledge entry.
      type: http
    http:
      method: PUT
      url: https://api.devin.ai/v1/knowledge/:knowledge_id
      params:
      - name: knowledge_id
        value: ''
        type: path
        description: The ID of the knowledge entry.
      body:
        type: json
        data: '{}'
    docs: Updates an existing knowledge entry.
  - info:
      name: Delete knowledge entry.
      type: http
    http:
      method: DELETE
      url: https://api.devin.ai/v1/knowledge/:knowledge_id
      params:
      - name: knowledge_id
        value: ''
        type: path
        description: The ID of the knowledge entry.
    docs: Deletes a knowledge entry.
- info:
    name: Playbooks
    type: folder
  items:
  - info:
      name: List playbooks.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/playbooks
    docs: Retrieves all team playbooks for the organization.
  - info:
      name: Create playbook.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/playbooks
      body:
        type: json
        data: "{\n  \"title\": \"Triage a bug report\",\n  \"body\": \"1. Reproduce the issue.\\n2. Write a failing test.\\\
          n3. Fix and open a PR.\"\n}"
    docs: Creates a new playbook.
  - info:
      name: Get playbook.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/playbooks/:playbook_id
      params:
      - name: playbook_id
        value: ''
        type: path
        description: The ID of the playbook.
    docs: Retrieves a playbook by ID.
  - info:
      name: Update playbook.
      type: http
    http:
      method: PUT
      url: https://api.devin.ai/v1/playbooks/:playbook_id
      params:
      - name: playbook_id
        value: ''
        type: path
        description: The ID of the playbook.
      body:
        type: json
        data: '{}'
    docs: Updates an existing playbook.
  - info:
      name: Delete playbook.
      type: http
    http:
      method: DELETE
      url: https://api.devin.ai/v1/playbooks/:playbook_id
      params:
      - name: playbook_id
        value: ''
        type: path
        description: The ID of the playbook.
    docs: Deletes a playbook.
- info:
    name: Secrets
    type: folder
  items:
  - info:
      name: List secrets.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v1/secrets
    docs: Lists all secrets for the organization. Returns metadata only, not values.
  - info:
      name: Create secret.
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v1/secrets
      body:
        type: json
        data: "{\n  \"type\": \"key-value\",\n  \"key\": \"STAGING_API_KEY\",\n  \"value\": \"changeme\",\n  \"sensitive\"\
          : true,\n  \"note\": \"Staging environment API key\"\n}"
    docs: Creates a new organization secret.
  - info:
      name: Delete a secret.
      type: http
    http:
      method: DELETE
      url: https://api.devin.ai/v1/secrets/:secret_id
      params:
      - name: secret_id
        value: ''
        type: path
        description: The ID of the secret.
    docs: Deletes a secret.
- info:
    name: Organizations (v3)
    type: folder
  items:
  - info:
      name: Create a session (v3, organization-scoped).
      type: http
    http:
      method: POST
      url: https://api.devin.ai/v3/organizations/:org_id/sessions
      params:
      - name: org_id
        value: ''
        type: path
        description: The organization ID.
      body:
        type: json
        data: "{\n  \"prompt\": \"Open a PR that upgrades the lodash dependency\"\n}"
    docs: v3 equivalent of session create, scoped to an organization, using a cog_ service-user or personal access token.
  - info:
      name: List organization users (v3).
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v3/organizations/members/users
    docs: Lists users in the organization for use with create_as_user_id.
- info:
    name: Enterprise (v3)
    type: folder
  items:
  - info:
      name: List enterprise organizations.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v3/enterprise/organizations
    docs: Lists every organization under the enterprise account.
  - info:
      name: List enterprise audit logs.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v3/enterprise/audit-logs
    docs: Paginated audit log entries with time-based filtering.
- info:
    name: Consumption
    type: folder
  items:
  - info:
      name: Get daily ACU consumption for the enterprise.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v3/enterprise/consumption/daily
    docs: Daily ACU consumption totals across the entire enterprise.
  - info:
      name: Get per-session daily ACU consumption.
      type: http
    http:
      method: GET
      url: https://api.devin.ai/v3/organizations/:org_id/consumption/sessions
      params:
      - name: org_id
        value: ''
        type: path
        description: The organization ID.
    docs: Per-session daily ACU consumption for an organization.
bundled: true