Skip to content

List Briefings

GET
/api/v1/briefings

List briefing records for the current tenant.

Returns briefings ordered by date DESC with cursor pagination. If cursor is provided, only records before that date are returned.

Args: cursor: Optional date cursor for pagination. limit: Maximum records to return (1-50). user: Authenticated user context. db: Async database session.

Returns: List of BriefingRecordResponse objects.

Authorizations

Parameters

Query Parameters

cursor
Any of:
string format: date

Cursor date for pagination

limit

Max records to return

integer
default: 20 >= 1 <= 50

Max records to return

Responses

200

Successful Response

Array<object>

Response model for a single briefing record.

Used by the /api/v1/briefings endpoints and consumed by the frontend briefing archive page.

object
annotation_count
required
integer
briefing_date
required
string format: date
created_at
required
string format: date-time
id
required
string format: uuid
kpi_snapshot_id
required
Any of:
string format: uuid
status
required
string
summary
required
Any of:
string
tenant_id
required
string format: uuid
video_url
required
Any of:
string

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string