Skip to main content
POST
Generate session insights
The devin_id is the session ID prefixed with devin- (e.g., devin-abc123).

Permissions

Requires a service user or personal access token with the ManageAccountSessions permission at the enterprise level.

Behavior

  • If a full analysis has already completed, or any analysis is currently in progress, the endpoint returns { "session_id": "abc123", "status": "already_exists" } without re-triggering.
  • If no insights exist, the last attempt failed, or the only completed analysis is classification-only (no issues, timeline, action items, suggested prompt, or knowledge/skill usage), the endpoint triggers a full analysis in the background and returns { "session_id": "abc123", "status": "started" }.
  • Poll the GET session insights endpoint to retrieve results once generation completes.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

devin_id
string | null
required

Devin session ID (prefix: devin-)

Example:

"devin-abc123def456"

Query Parameters

org_id
string | null

Response

Successful Response

Response from triggering session insights generation.

session_id
string
required

The session ID for which insights generation was triggered.

status
string
required

The status of the generation request.