Advanced Analytica Advanced Analytica: IBOM
← All connectors
Devin AI logo

Source connector

Devin AI

Set up Devin AI as a source and move its data into your chosen destination.

Version 0.3.1 community alpha

Devin AI

Set up the Devin AI source connector and find its reference information on this page.

Overview

Sync data from the Devin AI platform API (v3). View your organisation’s AI engineering agent activity, conversations and configuration.

  • Sessions: All Devin sessions in your organisation
    • 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 and their PR state
    • User and service user attribution
    • Session starting point (origin), such as webapp, slack, api or automation
    • Creating automation (automation_id)
    • Agent mode (devin_mode), use-case category (category, subcategory) and security profile (security_profile)
    • Parent and child session relationships
  • Sessions Insights: Sessions with aggregate insights
    • All fields from the Sessions stream
    • Message counts for each session (num_user_messages, num_devin_messages)
    • Session size classification (session_size)
    • AI-generated analysis of categories, programming languages, tools, frameworks, issues, note usage, suggested prompts and timelines
    • Analysis run state (analysis_status): started, completed, failed or null when analysis hasn’t run
    • analysis remains null until an analysis run completes
  • Session Messages: Full conversation history for each session
    • Every message exchanged between users and Devin
    • Message source attribution, either user or devin
    • Chronological order by timestamp
  • Playbooks: Reusable playbook definitions
    • Playbook title, body content and macro triggers
    • Access type
    • Authorship and modification tracking
  • Secrets: Secret metadata, with values never exposed
    • Secret keys, types and sensitivity flags
    • Access type and organisational scope
    • Creation and update audit trail
  • Knowledge Notes: Organisation knowledge base entries
    • Note content, folder organisation and trigger rules
    • Enabled or disabled state for automated knowledge injection
    • Pinned repository associations and macro triggers

Prerequisites

  • A Devin account with access to an organisation.
  • 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 creator’s permissions.
  • Enterprise accounts must first enable personal access tokens in their enterprise policy.
  • Your Devin organisation ID, which uses the org_ prefix.
  • The service user or personal access token needs the organisation-level permissions required for your selected streams:
    • ViewOrgSessions: Required for sessions, sessions_insights and session_messages.
    • UseDevinSessions: Required for playbooks and knowledge_notes.
    • ManageOrgSecrets: Required for secrets. The API returns only metadata and never exposes secret values.

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

Set up the connector

1. Create a service user and API key

  1. Sign in to app.devin.ai as an organisation admin.
  2. Open Settings → Devin API and select the Service users tab.
  3. Create a service user. Assign a role granting the permissions listed under Prerequisites.
  4. Generate an API key for the service user. The key appears only once when created.
  5. Copy the key and store it securely. All keys start with cog_.

2. Find your organisation ID

Find your organisation ID at the top of the Settings → Devin API page in app.devin.ai. It starts with org_.

3. Configure the connector in Airbyte

  1. Create a new Devin AI source in Airbyte.
  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 in UTC and ISO 8601 format, such as 2026-01-01T00:00:00Z.
  5. This limits the sessions, sessions_insights and session_messages streams to sessions created from that instant.
  6. Leave it empty to sync the full history.
  7. 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 from sessions, Airbyte makes one additional request for its messages.

Conversation history may contain PII. Enable this stream only when you need message-level data.

For aggregate message counts and Devin-generated classifications without raw message bodies, use sessions_insights instead.

The connector requests one message page for each session. By default, the Devin API returns up to 100 messages per page. For longer sessions, only the first 100 messages are synced.

Limitations

  • All streams support full refresh only, so each sync reads every record again.
  • Set Start Date to limit the sessions read by sessions, sessions_insights and session_messages.
  • The on_demand_usage field is populated only for organisations on a Devin Teams plan.
  • It’s 0 when your plan’s quota fully covered a session. The field is absent for other plans.
  • The connector retries requests returning HTTP 429 or 5xx responses.
  • It retries 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

Using Airbyte Cloud with IP-restricted access? Add the Airbyte Cloud IP addresses to your organisation’s allow list.

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
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.