Skip to main content

Devin AI

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Connector type
Available Data replicationNot available Agent(learn more)
Support Level
Marketplace
Connector Version
0.3.1 (last updated 4 days ago)
Sync Success Rate
High
Usage Rate
Low
Data workers used
0.2 per sync (Learn more)
Definition ID
3bc4954a-9ebe-48f5-b11d-8f52d61b10d5

This page contains the setup guide and reference information for the Devin AI source connector.

Overview​

Syncs data from the Devin AI platform API (v3), providing visibility into your organization's AI engineering agent activity, conversations, and configuration.

  • Sessions — All Devin sessions in your organization
    • Session status, title, tags, and timestamps
    • ACU consumption (acus_consumed) and on-demand spend in USD (on_demand_usage, Teams plans only)
    • Associated pull requests with PR state
    • User and service user attribution
    • Where the session was started (origin, such as webapp, slack, api, or automation) and the creating automation (automation_id)
    • Agent mode (devin_mode), use-case category (category, subcategory), and security profile (security_profile)
    • Parent/child session relationships
  • Sessions Insights — Sessions augmented with aggregate insights
    • All fields from the Sessions stream
    • Per-session message counts (num_user_messages, num_devin_messages)
    • Session size classification (session_size)
    • AI-generated analysis: category, programming languages, tools and frameworks, issues, note usage, suggested prompts, timeline
    • Analysis run state (analysis_status): started, completed, failed, or null if analysis never ran. analysis is null until an analysis run completes.
  • Session Messages — Full conversation history for each session
    • Every message exchanged between users and Devin
    • Message source attribution (user vs. devin)
    • Chronological ordering via timestamps
  • Playbooks — Reusable playbook definitions
    • Playbook title, body content, and macro triggers
    • Access type
    • Authorship and modification tracking
  • Secrets — Secret metadata (values are never exposed)
    • Secret keys, types, and sensitivity flags
    • Access type and organizational scope
    • Creation and update audit trail
  • Knowledge Notes — Organization knowledge base entries
    • Note content, folder organization, and trigger rules
    • Enabled/disabled state for automated knowledge injection
    • Pinned repo associations and macro triggers

Prerequisites​

  • A Devin account with access to an organization.
  • A Devin API key. All Devin API credentials use the cog_ prefix. A service user API key is recommended. A personal access token also works and has the same permissions as the user who created it. Enterprise accounts must enable personal access tokens in their enterprise policy first.
  • Your Devin organization ID (uses the org_ prefix).
  • The service user or personal access token must have the organization-level Devin permissions required to read the streams you want to sync:
    • ViewOrgSessions: required for sessions, sessions_insights, and session_messages.
    • UseDevinSessions: required for playbooks and knowledge_notes.
    • ManageOrgSecrets: required for secrets. Only metadata is returned; secret values are never exposed.

For a full permission reference, see the Devin Permissions & RBAC documentation.

Setup guide​

Step 1: Create a service user and API key​

  1. Sign in to app.devin.ai as an organization admin.
  2. Open Settings → Devin API and select the Service users tab.
  3. Create a service user and assign a role that grants the permissions listed under Prerequisites.
  4. Generate an API key for the service user. The key is shown only once at creation — copy and store it securely. All keys start with cog_.

Step 2: Find your organization ID​

Your organization ID is shown at the top of the Settings → Devin API page in app.devin.ai. It starts with org_.

Step 3: Configure the connector in Airbyte​

  1. In Airbyte, create a new Devin AI source.
  2. Enter your API Token (the cog_... key from Step 1).
  3. Enter your Organization ID (the org_... value from Step 2).
  4. Optionally, set a Start Date (UTC, ISO 8601 format, for example 2026-01-01T00:00:00Z) to limit the sessions, sessions_insights, and session_messages streams to sessions created on or after that instant. Leave empty to sync full history.
  5. Click Test Connection to verify your credentials.

Supported streams​

StreamSync ModeDescription
SessionsFull RefreshAll Devin sessions in your organization
Sessions InsightsFull RefreshSessions enriched with message counts, size classification, and AI-generated analysis
Session MessagesFull RefreshConversation messages for each session
PlaybooksFull RefreshPlaybooks owned by the organization. Enterprise-level playbooks aren't synced.
SecretsFull RefreshSecret metadata (no secret values are synced)
Knowledge NotesFull RefreshKnowledge notes for the organization

The session_messages stream is a substream of sessions: for each session returned by sessions, Airbyte issues one additional request to fetch that session's messages. Conversation history may contain PII, so only enable this stream when you need message-level data. For aggregate message counts and Devin-generated classification without raw message bodies, use sessions_insights instead.

The connector requests a single page of messages for each session, and the Devin API returns up to 100 messages per page by default. For sessions with more than 100 messages, only the first 100 messages are synced.

Limitations​

  • All streams support full refresh only. Each sync re-reads every record. To limit the sessions that sessions, sessions_insights, and session_messages read, set Start Date.
  • The on_demand_usage field is populated only for organizations on a Devin Teams plan. It's 0 when a session was fully covered by your plan's quota, and absent for other plans.
  • The connector retries requests that fail with HTTP 429 or 5xx responses, up to five times with exponential backoff.

Configuration reference​

ParameterTypeRequiredDefaultDescription
api_tokenstringYesDevin API key for authentication. All Devin API credentials use the cog_ prefix.
org_idstringYesYour Devin organization ID. Uses the org_ prefix.
start_datestring (ISO 8601, UTC)No(no filter)Optional lower bound on created_at for the sessions, sessions_insights, and session_messages streams. Sessions created before this instant are excluded. Format: YYYY-MM-DDTHH:MM:SSZ. Example: 2026-01-01T00:00:00Z.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
api_token
string
org_id
string
start_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.3.12026-10-2789826Update dependencies
0.3.02026-10-2189592Add on_demand_usage, devin_mode, origin, category, subcategory, automation_id, and security_profile to sessions and sessions_insights; add analysis_status to sessions_insights
0.2.192026-10-2089148Update dependencies
0.2.182026-10-1388586Update dependencies
0.2.172026-10-0687810Update dependencies
0.2.162026-09-2987099Update dependencies
0.2.152026-09-2286554Update dependencies
0.2.142026-09-1586013Update dependencies
0.2.132026-09-0885448Update dependencies
0.2.122026-08-1884527Update dependencies
0.2.112026-08-1183901Update dependencies
0.2.102026-08-0483423Update dependencies
0.2.92026-07-2882877Update dependencies
0.2.82026-07-2182361Update dependencies
0.2.72026-07-1481770Update dependencies
0.2.62026-07-0781037Update dependencies
0.2.52026-06-2380426Update dependencies
0.2.42026-06-1679827Update dependencies
0.2.32026-06-0979281Update dependencies
0.2.22026-06-0278663Update dependencies
0.2.12026-04-2877201Update dependencies
0.2.02026-04-2276475Add sessions_insights stream for analytics (message counts, session size, AI-generated classification); add optional start_date config to filter sessions, sessions_insights, and session_messages by creation time
0.1.12026-04-2176504Update dependencies
0.1.02026-04-1574417Initial release with sessions, session messages, playbooks, secrets, and knowledge notes streams
Was this page helpful?