---
title: "Save Meetings"
method: PUT
path: "/v1/compass/meetings"
tags: ["compass"]
---

# Save Meetings

`PUT /v1/compass/meetings`

## Request

- Base URL: `https://api.evidenso.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.evidenso.com/v1/compass/meetings`
- Auth: HTTP bearer

Save the app's meeting records, each by its key: a new key is a new record, a known one is rewritten.

The backend links each to the call coached in it (the caller's call with the same `meeting_key`) and keeps it
until 90 days after the meeting ends, or as long as a call in it is kept; the app never sets either. A meeting
that ended more than 90 days ago is not stored, so `saved` can be less than what was sent. The same key twice:
the later one is saved. A save keeps what another of the user's Macs saw of the offer (see the repository's
upsert).

## Request body

- MeetingsRequest
  - `meetings` MeetingRecord[], required
    - `meeting_key` string, required
    - `source` 'google' | 'mac', nullable
    - `series` string, nullable
    - `starts_at` string, date-time, required
    - `ends_at` string, date-time, required
    - `title` string, nullable
    - `attendees` Attendee[]
      - `name` string, nullable
      - `email` string, nullable
      - `outside` boolean, required
      - `named` boolean, required
    - `customer_call` boolean, required
    - `customer_call_source` 'user' | 'classifier' | 'rule', nullable
    - `goal` string, nullable
    - `goal_source` 'user' | 'compass' | 'invite' | 'last_call', nullable
    - `notes` string, nullable
    - `notes_source` 'user' | 'compass', nullable
    - `offered_at` string, date-time, nullable
    - `offer_via` 'calendar' | 'detected', nullable
    - `offer_answer` 'coach' | 'skip', nullable
    - `not_offered_reason` 'app_closed' | 'offers_off' | 'internal' | 'busy' | 'missed', nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/evidenso/apis/persona-rag-api.md) - [All operations](https://skmtc.dev/evidenso/apis/persona-rag-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evidenso/apis/persona-rag-api/revisions/86408c178d4f?raw)