Skip to main content
POST
/
v3
/
organizations
/
{org_id}
/
sessions
/
{devin_id}
/
insights
/
generate
Generate session insights
curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/insights/generate \
  --header 'Authorization: Bearer <token>'
{
  "session_id": "<string>",
  "status": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

The devin_id is the session ID prefixed with devin- (e.g., devin-abc123).

​
Permissions

Requires a service user with the ManageOrgSessions permission at the organization level.

​
Behavior

  • If insights have already been generated (or generation is in progress), the endpoint returns { "status": "already_exists" } without re-triggering.
  • If no insights exist (or the last attempt failed), the endpoint triggers generation in the background and returns { "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"

​
org_id
string | null
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

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.