Quick start: Teams

This guide walks you through setting up API access for teams and standard organizations (non-enterprise). You’ll create a service user, get your credentials, and make your first API call in minutes.

If you’re part of an enterprise with multiple organizations, custom roles, or SSO, see the Enterprise quick start instead.

Step 1: Create a service user

Go to Settings > Devin API in your organization and open the Service users tab
Click Provision service user
Choose a descriptive display name (e.g., “CI Pipeline”, “Monitoring Bot”)
Select a role:
- Admin — full access, including organization settings and membership
- Member — can create and manage Devin sessions and most organization resources, but not organization settings or membership

Use the Member role for most automation. Only use Admin if your integration needs to manage org settings or other users.

Step 2: Copy your API key

After you provision the service user, its API key is shown in a dialog
Copy the key immediately — it starts with cog_ and won’t be shown again
Store it securely as an environment variable:

export DEVIN_API_KEY="cog_your_key_here"

Step 3: Make your first API call

Create a Devin session:

export DEVIN_ORG_ID="your_org_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a simple Python script that prints Hello World"}'

Find your organization ID at the top of the Settings → Devin API page.

Want sessions attributed to your user? By default, sessions are attributed to the service user. To create sessions on behalf of a specific user (so they appear in that user’s session list), add "create_as_user_id": "user_abc123" to the request body. This requires the Admin role (which includes the ImpersonateOrgSessions permission). See Session attribution for details.

Step 4: Common operations

List your sessions

curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

Send a message to a running session

export SESSION_ID="your_session_id"

curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/sessions/$SESSION_ID/messages" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "Please also add unit tests"}'

Manage knowledge

# List knowledge entries
curl "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY"

# Create a knowledge entry
curl -X POST "https://api.devin.ai/v3/organizations/$DEVIN_ORG_ID/knowledge/notes" \
  -H "Authorization: Bearer $DEVIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Coding standards", "trigger": "When writing code", "body": "Use TypeScript strict mode..."}'

Permissions for teams users

Teams organizations have a simple permission model:

Role	Can create sessions	Can manage resources	Can manage settings
Member	Yes	Yes (knowledge, playbooks, secrets)	No
Admin	Yes	Yes	Yes

For fine-grained role-based access control (RBAC), see the Enterprise quick start.

Next steps

Browse the Organization API endpoints in the sidebar
See common flows for common integration patterns
Learn about authentication in depth
Set up scheduled automations for recurring tasks

Getting Started

Concepts

Agent Lifecycle

Context Management

Environment Management

Automation

Integrations

Analytics

Observability

Devin for Security

Infrastructure

Identity & Access

Configuration

Legacy API v1

Legacy API v2

Step 1: Create a service user

Step 2: Copy your API key

Step 3: Make your first API call

Step 4: Common operations

List your sessions

Send a message to a running session

Manage knowledge

Permissions for teams users

Next steps

​Step 1: Create a service user

​Step 2: Copy your API key

​Step 3: Make your first API call

​Step 4: Common operations

​List your sessions

​Send a message to a running session

​Manage knowledge

​Permissions for teams users

​Next steps

Step 1: Create a service user

Step 2: Copy your API key

Step 3: Make your first API call

Step 4: Common operations

List your sessions

Send a message to a running session

Manage knowledge

Permissions for teams users

Next steps