Admin API
Sources
Create sources, rotate their write keys and revoke previous keys.
A source is where events come from, identified by its write key. The key is shown once at creation; only its hash and prefix are stored.
Rotating a key keeps the previous one valid for a grace period (24 hours by default), and previous keys can be revoked early. Disabling a source makes ingest refuse its events.
Operations
| Operation | Request | Who may call it |
|---|---|---|
| listSources | GET /v1/workspaces/{ws}/sources | viewer or above; staff: super, support |
| createSource | POST /v1/workspaces/{ws}/sources | admin |
| deleteSource | DELETE /v1/workspaces/{ws}/sources/{id} | admin |
| updateSource | PATCH /v1/workspaces/{ws}/sources/{id} | editor or above |
| revokePreviousKeys | DELETE /v1/workspaces/{ws}/sources/{id}/previous-keys | admin |
| rotateSourceKey | POST /v1/workspaces/{ws}/sources/{id}/rotate-key | admin |
This is the console’s API, not a public one: requests reach it only through the console’s server, for a signed-in user. There are no API keys for it yet. It is listed so you know what each action does and which role it needs.