Getting Started
Introduction
DeepaData is the governance layer for emotional AI. Extract structured affective records, seal them with cryptographic integrity proofs, and observe how your AI systems handle emotion in production.
Base URL: https://www.deepadata.com/api/v1
Getting Started
New to DeepaData? Start here.
API Reference
Explore the full API by product group. Select an endpoint to see request/response details.
POST
/v1/observescope: extractCapture a lightweight SalienceRecord at topic-shift boundaries. Returns state_change, significance, affect signal, and escalation recommendation. ~5 second response time.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
| content | string | required | The passage content to analyze (max 20,000 characters). |
| subject_id | string | required | Subject identifier (your client/user ID or VitaPass vp_id). |
| session_id | string | optional | Session identifier for grouping observations. |
| trigger | string | optional | What triggered this observation: 'topic_shift' | 'affect_shift' | 'user_mark' | 'time_gap' | 'recurrence'. Default: 'topic_shift'. |
| previous_state | string | optional | Previous state_change for continuity context. |
Example request
{
"content": "Client mentioned feeling overwhelmed at work, then shifted to discussing relationship concerns with their partner.",
"subject_id": "client-12345",
"session_id": "session-abc",
"trigger": "topic_shift"
}Example response
{
"success": true,
"data": {
"record": {
"observation_date": "2026-02-20T14:30:00.000Z",
"subject_id": "client-12345",
"session_id": "session-abc",
"state_change": "Shifted from work stress to relationship concerns",
"significance": "Pattern of externalizing stress onto relationship",
"trigger": "topic_shift",
"affect_intensity": 0.7,
"affect_valence": "negative",
"priority": "medium",
"passage_hash": "sha256:abc123...",
"escalate_recommended": false
}
},
"meta": {
"latency_ms": 4823
}
}Error codes
400'content' and 'subject_id' fields are required
401Missing or invalid API key
403API key does not have 'extract' scope
429Rate limit exceeded