Plum / developers
REST APISources

List sources

GET/sources

Authorization

bearerAuth
AuthorizationBearer <token>

Send Authorization: Bearer <token> with one of: an app session access token from /auth/verify-otp or /auth/refresh; an OAuth access token from /oauth/token issued for the API origin (its scopes are its permissions); or a personal access token starting with optima_pat_ (see /docs/personal-access-tokens). Personal access tokens cannot create or list tokens, revoke other tokens, sign out, or delete or restore the account. Content routes need the permission of their layer: audio:read/audio:write for recordings, turns:read/turns:write for turns, contacts, source signals, and events, and insights:read/insights:write for suggestions and session summaries; search and recall need turns:read and insights:read. A request without the permission, or for an account whose layer is turned off, returns 403 FORBIDDEN. See /docs/authentication#scopes.

In: header

Query Parameters

limit?number
cursor?string
Formatuuid

Header Parameters

X-API-Version?"1"

Send 1 to pin the documented API contract. If omitted, the latest version is selected.

Default"1"

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sources" \  -H "X-API-Version: 1"
{  "success": true,  "data": {    "items": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "kind": "string",        "name": "string",        "created_at": "2019-08-24T14:15:22Z"      }    ],    "cursor": "string"  }}

Start a session POST

Start a session on an idle, online shared recorder, with you as host. The recorder adopts it within seconds and records to your account until the scheduled end. Recordings go to your one source for this recorder. A recorder with an open session returns 409 SESSION_ACTIVE; one that has not contacted Optima in the last 90 seconds returns 409 RECORDER_OFFLINE. See [Devices](/docs/devices#shared-recorders).

Create a source POST

Register an app installation's source by installation_ref, or get the account's single api source with kind api, which is created on first use. Repeating a registration returns the existing source.