> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.saturnos.com/partner/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.saturnos.com/_mcp/server.

# Overview

Saturn's external API for firms integrating their own systems.

## Authentication

Every request needs your API key:

Authorization: Api-Key \<your key>

The key identifies your firm. All data returned is your firm's data, and only your firm's data — there is no parameter to select an organisation, and any attempt to supply one is ignored.

Keys are shown once at creation and cannot be recovered. If a key is lost or exposed, ask Saturn to revoke it and issue a new one.

## Identifying records

Every record has a `saturn_ref_id` — a UUID that is stable for the life of the record. Store it when you first see a record and use it for every later request.

You do not tell Saturn which CRM you use, and there are no CRM-specific identifiers or endpoints. If you have no CRM integration at all, this API still works exactly the same way.

## Response shape

Successful responses:

\{ "success": true, "data": \{ ... }, "error": null }

List responses add pagination:

\{ "success": true, "data": \[ ... ],
"meta": \{ "pagination": \{ "count": 120, "limit": 10, "offset": 0 } } }

Optional fields are `null` when unset, never an empty string, so you can distinguish "not recorded" from "empty".

## Status codes

| Code | Meaning                                                                                                   |
| ---- | --------------------------------------------------------------------------------------------------------- |
| 200  | Success                                                                                                   |
| 400  | Invalid request — malformed id or bad parameter                                                           |
| 401  | Missing, invalid, revoked or expired API key                                                              |
| 403  | Your key lacks the scope for this operation                                                               |
| 404  | Not found. Also returned for a record belonging to another firm — the two are indistinguishable by design |
| 429  | Rate limit exceeded. Check `Retry-After`                                                                  |
| 502  | A Saturn upstream service is unavailable. Retry; this does not mean the data is missing                   |

A 404 for another firm's record is deliberate: a 403 would confirm the record exists, which would let anyone probe for valid ids.

## Rate limits

Limits are per key. `X-RateLimit-Limit` and `X-RateLimit-Remaining` are returned on every response. If you are backfilling and need a higher ceiling, ask before you start rather than discovering the limit mid-run.

## Docs

- [Overview](https://developer.saturnos.com/partner/accounts.md)
- [Overview](https://developer.saturnos.com/partner/contacts.md)
- [Overview](https://developer.saturnos.com/partner/employees.md)
- [Overview](https://developer.saturnos.com/partner/meeting-notes.md)

## API Docs

- Partner > Accounts [List accounts](https://developer.saturnos.com/partner/accounts/list-accounts.md)
- Partner > Accounts [Create account](https://developer.saturnos.com/partner/accounts/create-account.md)
- Partner > Accounts [Get account](https://developer.saturnos.com/partner/accounts/get-account.md)
- Partner > Accounts [Delete account](https://developer.saturnos.com/partner/accounts/delete-account.md)
- Partner > Accounts [Update account](https://developer.saturnos.com/partner/accounts/update-account.md)
- Partner > Accounts [Assign contacts to account](https://developer.saturnos.com/partner/accounts/assign-contacts-to-account.md)
- Partner > Accounts [Unassign contact from account](https://developer.saturnos.com/partner/accounts/unassign-contact-from-account.md)
- Partner > Contacts [List contacts](https://developer.saturnos.com/partner/contacts/list-contacts.md)
- Partner > Contacts [Create contact](https://developer.saturnos.com/partner/contacts/create-contact.md)
- Partner > Contacts [Get contact](https://developer.saturnos.com/partner/contacts/get-contact.md)
- Partner > Contacts [Delete contact](https://developer.saturnos.com/partner/contacts/delete-contact.md)
- Partner > Contacts [Update contact](https://developer.saturnos.com/partner/contacts/update-contact.md)
- Partner > Employees [List employees](https://developer.saturnos.com/partner/employees/list-employees.md)
- Partner > Employees [Create employee](https://developer.saturnos.com/partner/employees/create-employee.md)
- Partner > Employees [Get employee](https://developer.saturnos.com/partner/employees/get-employee.md)
- Partner > Employees [Delete employee](https://developer.saturnos.com/partner/employees/delete-employee.md)
- Partner > Employees [Update employee](https://developer.saturnos.com/partner/employees/update-employee.md)
- Partner > Employees [Assign advisors (support)](https://developer.saturnos.com/partner/employees/assign-advisors-support.md)
- Partner > Employees [Get client manager assignments](https://developer.saturnos.com/partner/employees/get-client-manager-assignments.md)
- Partner > Employees [Assign advisors (client manager)](https://developer.saturnos.com/partner/employees/assign-advisors-client-manager.md)
- Partner > Employees [Set firm-wide (support)](https://developer.saturnos.com/partner/employees/set-firm-wide-support.md)
- Partner > Employees [Clear firm-wide (support)](https://developer.saturnos.com/partner/employees/clear-firm-wide-support.md)
- Partner > Employees [Unassign advisor (support)](https://developer.saturnos.com/partner/employees/unassign-advisor-support.md)
- Partner > Employees [Set firm-wide (client manager)](https://developer.saturnos.com/partner/employees/set-firm-wide-client-manager.md)
- Partner > Employees [Clear firm-wide (client manager)](https://developer.saturnos.com/partner/employees/clear-firm-wide-client-manager.md)
- Partner > Employees [Unassign advisor (client manager)](https://developer.saturnos.com/partner/employees/unassign-advisor-client-manager.md)
- Partner > Meeting Notes [List meeting notes](https://developer.saturnos.com/partner/meeting-notes/list-meeting-notes.md)
- Partner > Meeting Notes [Get meeting note](https://developer.saturnos.com/partner/meeting-notes/get-meeting-note.md)
- Partner > Meeting Notes [Get Meeting Artifacts](https://developer.saturnos.com/partner/meeting-notes/get-meeting-artifacts.md)
- Partner > Meeting Notes [Get fact find](https://developer.saturnos.com/partner/meeting-notes/get-fact-find.md)
- Partner > Webhooks [Register a webhook](https://developer.saturnos.com/partner/webhooks/register-a-webhook.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developer.saturnos.com/partner/openapi.json)
- [OpenAPI YAML](https://developer.saturnos.com/partner/openapi.yaml)