Skip to main content
POST
/
v3
/
enterprise
/
sessions
/
{devin_id}
/
insights
/
generate
Generate session insights
curl --request POST \
  --url https://api.devin.ai/v3/enterprise/sessions/{devin_id}/insights/generate \
  --header 'Authorization: Bearer <token>'
{
  "session_id": "<string>",
  "status": "<string>"
}
The devin_id is the session ID prefixed with devin- (e.g., devin-abc123).

​
Permissions

Requires a service user with the ManageAccountSessions permission at the enterprise 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"

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.