List sessions with insights

GET

https://api.devin.ai/v3/organizations/:org_id/sessions/insights

GET

/v3/organizations/:org_id/sessions/insights

curl https://api.devin.ai/v3/organizations/org-abc123def456/sessions/insights \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "items": [
    {
      "acus_consumed": 12.7,
      "created_at": 1680412800,
      "num_devin_messages": 15,
      "num_user_messages": 8,
      "org_id": "org-abc123def456",
      "pull_requests": [
        {
          "state": "open",
          "url": "https://github.com/org/repo/pull/42"
        }
      ],
      "session_id": "sess-3456mnop",
      "session_size": "m",
      "status": "running",
      "tags": [
        "urgent",
        "backend",
        "security"
      ],
      "updated_at": 1680499200,
      "url": "https://app.devin.ai/sessions/sess-3456mnop",
      "analysis": {
        "action_items": [
          {
            "action_item": "Refactor authentication module to improve security",
            "issue_id": "issue-7890",
            "type": "refactoring_and_optimization"
          },
          {
            "action_item": "Update CI pipeline to include security scans",
            "issue_id": null,
            "type": "ci_cd_and_devops"
          }
        ],
        "classification": {
          "category": "bug_fixing",
          "confidence": 0.92,
          "programming_languages": [
            "Python",
            "JavaScript"
          ],
          "tools_and_frameworks": [
            "Django",
            "React",
            "Jenkins"
          ]
        },
        "issues": [
          {
            "impact": "High",
            "issue": "Authentication bypass vulnerability",
            "label": "security",
            "id": "issue-7890"
          }
        ],
        "note_usage": {
          "bad_usages": [
            {
              "message": "Note was outdated and referenced deprecated API",
              "note_id": "note-1234",
              "reason": "Outdated information"
            }
          ],
          "good_usages": [
            {
              "message": "Note clearly explained the bug reproduction steps",
              "note_id": "note-5678",
              "reason": "Clear and actionable"
            }
          ]
        },
        "suggested_prompt": {
          "original_prompt": "Fix the bug in the login flow",
          "suggested_prompt": "Fix the authentication bug causing login failures under certain conditions",
          "feedback_items": [
            {
              "details": "Prompt could be more specific about the error context",
              "excerpt": "Fix the bug in the login flow",
              "summary": "Improve prompt specificity",
              "issue_id": null
            }
          ]
        },
        "timeline": [
          {
            "description": "Session started and initial analysis began",
            "title": "Session Start",
            "color": "green",
            "issue_id": null
          },
          {
            "description": "Waiting for user input on bug details",
            "title": "User Input Required",
            "color": "yellow",
            "issue_id": null
          }
        ]
      },
      "category": "bug_fixing",
      "child_session_ids": [
        "sess-child-001",
        "sess-child-002"
      ],
      "is_archived": false,
      "origin": "webapp",
      "parent_session_id": null,
      "playbook_id": "pb-1122aabb",
      "service_user_id": "svc-9012ijkl",
      "status_detail": "working",
      "structured_output": {
        "summary": "Fixed authentication bug and updated CI pipeline",
        "tests_passed": true
      },
      "subcategory": "security",
      "title": "Authentication Bug Fix Session",
      "user_id": "user-1234abcd"
    }
  ],
  "end_cursor": "cursor-abc123",
  "has_next_page": true,
  "total": 125
}

List sessions with detailed insights including message counts, session size classification, and AI-generated analysis.

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Path parameters

org_idstringRequired

Organization ID (prefix: org-)

Query parameters

qsobjectRequired

devin_idstring or nullOptional

Response

Successful Response

itemslist of objects

end_cursorstring or nullOptional

Cursor to fetch the next page, or None if this is the last page.

has_next_pagebooleanOptionalDefaults to false

Whether there are more items available after this page.

totalinteger or nullOptional

Optional total count (can be omitted for performance).

Errors

422

Unprocessable Entity Error