Skip to main content

Analyses

AI-generated insights for individual content items.

List Analyses​

GET /v1/projects/{projectId}/content/{contentId}/analyses

Returns all analyses for a content item.

Request​

curl https://scribesight.com/api/v1/projects/proj_xxx/content/cont_xxx/analyses \
  -H "Authorization: Bearer sk_live_xxx"

Response​

{
  "data": [
    {
      "id": "ana_xxxxxxxxxxxx",
      "content_id": "cont_xxxxxxxxxxxx",
      "prompt_id": "prompt_xxxxxxxxxxxx",
      "prompt_name": "Sales Call Analysis",
      "status": "completed",
      "version": 1,
      "confidence_score": 87,
      "created_at": "2026-01-05T15:30:00Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}

Get Analysis​

GET /v1/projects/{projectId}/content/{contentId}/analyses/{analysisId}

Returns a specific analysis with full results.

Request​

curl https://scribesight.com/api/v1/projects/proj_xxx/content/cont_xxx/analyses/ana_xxx \
  -H "Authorization: Bearer sk_live_xxx"

Response​

{
  "data": {
    "id": "ana_xxxxxxxxxxxx",
    "content_id": "cont_xxxxxxxxxxxx",
    "prompt_id": "prompt_xxxxxxxxxxxx",
    "prompt_name": "Sales Call Analysis",
    "status": "completed",
    "version": 1,
    "confidence_score": 87,
    "result": {
      "summary": "Discovery call with prospect interested in enterprise plan...",
      "sentiment": "positive",
      "key_topics": ["pricing", "implementation", "integrations"],
      "action_items": [
        "Send proposal by Friday",
        "Schedule demo with technical team"
      ],
      "deal_probability": 0.75,
      "objections": [
        {
          "topic": "pricing",
          "concern": "Budget constraints for Q1",
          "response": "Discussed payment plans"
        }
      ]
    },
    "model_used": "gpt-4o",
    "processing_time_ms": 3420,
    "created_at": "2026-01-05T15:30:00Z"
  }
}

Trigger Analysis​

POST /v1/projects/{projectId}/content/{contentId}/analyze

Triggers a new analysis for content.

Request Body​

FieldTypeRequiredDescription
prompt_idstringNoPrompt to use (defaults to project/org default)
force_newbooleanNoCreate new analysis even if one exists

Request​

curl -X POST https://scribesight.com/api/v1/projects/proj_xxx/content/cont_xxx/analyze \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt_id": "prompt_xxx",
    "force_new": true
  }'

Response​

{
  "data": {
    "analysis_id": "ana_yyyyyyyyyyyy",
    "status": "queued",
    "message": "Analysis job queued"
  }
}

The analysis runs asynchronously. Use webhooks to be notified when it completes.