List Recorder Meetings

curl --request GET \
  --url https://api.attention.tech/v2/recorder_metrics/all_meetings \
  --header 'Authorization: <api-key>'

{
  "items": [
    {
      "uuid": "<string>",
      "summary": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "userUuid": "<string>",
      "userName": "<string>",
      "status": "<string>",
      "statusLabel": "<string>",
      "participants": [
        {
          "userUuid": "<string>",
          "userName": "<string>",
          "status": "<string>",
          "statusLabel": "<string>"
        }
      ],
      "conversationUuid": "<string>",
      "consentLinkUsed": true,
      "consentStatus": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

RecorderMetrics

List Recorder Meetings

Returns a cursor-paginated, deduplicated list of calendar meetings for the authenticated organization with the recording status of each meeting and each org participant. One row per calendar event.

Intended for bulk export to data warehouses and analytics pipelines. Requires an organization-level API key — user-scoped keys are rejected.

Window

fromDateTime and toDateTime are required and must define a window of at most 90 days.
When upcoming=true, results are ordered ascending by date; otherwise descending. UUID is used as a stable tiebreaker for same-date meetings.

Pagination

Cursor-based. The first page is requested with no cursor. The response’s nextCursor is passed back unchanged on the next call.
When the response has no nextCursor, the iteration has reached the end of the dataset.
size is clamped to a server-side maximum of 200 (default 50).
For periodic backfills, run a complete iteration per refresh (start each refresh with no cursor); rows inserted into the window after an iteration starts are picked up on the next refresh.

Meeting `status` values

Attention’s native status taxonomy is returned as-is. Values currently surfaced (non-exhaustive list, subject to additive evolution): recorded, calendar_event_cancelled, empty_recording, user_override, event_not_accepted, not_join_internal_team_meetings, external_meetings_disabled, blacklisted_attendees, not_join_when_alone, bot_disabled, bot_removed, waiting_room, technical_error, no_meeting_link, bot_not_scheduled, scheduled_future.

Clients should map these codes to their own reporting taxonomy on the consumer side (e.g. dbt models, BI views).

Field semantics

uuid — calendar event UUID (deduplication key).
conversationUuid — populated only when a recording exists (status=recorded).
userUuid / userName — the user attributed as the recorder; falls back to the first event participant when no recording exists.
participants[] — every org user invited to the event with their per-user status (a user may be recorded while another is not_join_when_alone on the same meeting).
statusLabel — human-readable label resolved server-side, suitable for direct display.

GET

recorder_metrics

all_meetings

List Recorder Meetings

curl --request GET \
  --url https://api.attention.tech/v2/recorder_metrics/all_meetings \
  --header 'Authorization: <api-key>'

{
  "items": [
    {
      "uuid": "<string>",
      "summary": "<string>",
      "date": "2023-11-07T05:31:56Z",
      "userUuid": "<string>",
      "userName": "<string>",
      "status": "<string>",
      "statusLabel": "<string>",
      "participants": [
        {
          "userUuid": "<string>",
          "userName": "<string>",
          "status": "<string>",
          "statusLabel": "<string>"
        }
      ],
      "conversationUuid": "<string>",
      "consentLinkUsed": true,
      "consentStatus": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization

string

header

required

Query Parameters

fromDateTime

string<date-time>

required

Window start (inclusive), ISO 8601 date-time, e.g. 2026-04-01T00:00:00Z.

toDateTime

string<date-time>

required

Window end (inclusive), ISO 8601 date-time. Must be after fromDateTime and within 90 days of it.

cursor

string

Opaque cursor returned by a previous call. Omit on the first page.

size

integer

Items per page. Defaults to 50. Server-side maximum is 200; values above are clamped.

upcoming

boolean

When true, returns meetings whose start time is in the future (ascending order). Defaults to false (past meetings, descending order).

filter[user_id]

string[]

Restrict the dedup pass to meetings involving any of the given user UUIDs. UUIDs not belonging to the authenticated organization are silently dropped; if none survive, an empty page is returned to avoid cross-tenant membership probing.

filter[meeting_type]

enum<string>

Restrict results to internal (all org participants) or external meetings.

Available options:

internal,

external

Response

Cursor-paginated list of meetings with recording status

items

object[]

required

Page of meetings ordered by date (ascending when upcoming=true, descending otherwise) with UUID as tiebreaker.

Show child attributes

nextCursor

string

Opaque cursor for the next page. Absent (or empty) when the iteration has reached the end of the dataset.

Update Field Configuration Item

⌘I