Reference
Action items, speakers and tags
Lists across all recordings
1 min read
These endpoints work across all recordings the key can see. With an organization key, add ?userId= to limit them to one member. All of them support limit and offset.
Action items
GET /action-itemsScope: action-items:list
| Parameter | Description |
|---|---|
status | BACKLOG, TODO, IN_PROGRESS or DONE |
priority | LOW, MEDIUM, HIGH or URGENT |
owner | Case-insensitive match on the owner's name |
speakerId | Owned by this speaker profile |
from, to | ISO 8601 dates, on when the item was created |
userId | Organization keys only |
Results are sorted by status, then priority (highest first).
curl "https://developers.caven.io/public/v1/action-items?status=todo&priority=high" \
-H "X-API-Key: sk_your_key_here"{
"data": [
{
"id": "cmuvejgaq00izrv927dp1xlvn",
"recordingId": "cmat10lv8f4yn83oy3iofv0n3",
"userId": "cmjal5xyj0000vaz4po9spv16",
"title": "Send the revised plan to the client",
"description": null,
"owner": "Speaker B",
"ownerSpeakerProfileId": null,
"sourceSummaryId": "cmuvejep600gjrv92wzifu9ke",
"sourceType": "SUMMARY",
"status": "TODO",
"priority": "HIGH",
"position": 1000,
"meetingTitle": null,
"meetingLink": null,
"calendarEventId": null,
"syncedToCalendar": false,
"syncedCalendarEventId": null,
"dueDate": null,
"completedAt": null,
"createdAt": "2026-10-05T15:25:53.859Z",
"updatedAt": "2026-10-05T15:25:53.859Z"
}
],
"meta": { "total": 1, "limit": 20, "offset": 0 }
}sourceType is SUMMARY for items Caven extracted from a summary. sourceSummaryId then points to that summary.
Speakers
GET /speakersScope: speakers:list
| Parameter | Description |
|---|---|
status | PENDING or READY |
search | Case-insensitive match on name or email |
userId | Organization keys only |
{
"data": [
{
"id": "cmsp...",
"userId": "cmjal5xyj0000vaz4po9spv16",
"organizationId": "cmosioqps0002ugawapstnrwy",
"name": "Jane Doe",
"email": "[email protected]",
"status": "READY",
"sampleCount": 4,
"createdAt": "2026-06-01T09:00:00.000Z",
"updatedAt": "2026-09-12T14:21:08.000Z"
}
],
"meta": { "total": 1, "limit": 20, "offset": 0 }
}With an organization key, this list is always empty if the organization has turned off the speaker catalog. That setting doesn't apply to personal keys.
Tags
GET /tagsScope: tags:list
| Parameter | Description |
|---|---|
search | Case-insensitive match on the name |
userId | Organization keys only |
{
"data": [
{
"id": "cmtg...",
"name": "Sales",
"color": "#3b82f6",
"userId": "cmjal5xyj0000vaz4po9spv16",
"organizationId": null,
"createdAt": "2026-05-10T08:00:00.000Z",
"updatedAt": "2026-05-10T08:00:00.000Z"
}
],
"meta": { "total": 1, "limit": 20, "offset": 0 }
}Use a tag's id with /recordings?tagId= to find its recordings.