Skip to main content

Licenses

A license is assigned to every membership. This lookup resolves the licenseId you find on memberships and invitations.

Every endpoint below shows its parameters and response fields in the middle and a request sample with an example response on the right.

Base URL https://api.sally.ioVersion v1.0 current, not frozen yetHow versioning works

Lists the licenses (resolves `licenseId`)​

GET/v1.0/licenses
Field overview from the specification

Each item has:

  • licenseId (string): id of the license.
  • name (string): license name (tier).

Query parameters

  • fieldsstringoptional

    Comma-separated list of the fields to return. Leave it out and you get every field — including fields added in the future, which is your call to make: name your fields if you want to be shielded from that.

    Only first-level fields can be named. A nested list such as attendees, tags or sectionItems is returned whole or not at all; attendees.name is not supported.

    On a paged response the selection applies to the entries in items; page, pageSize, total and hasMore are always returned. An unknown name is rejected with 400 rather than ignored.

    Selectable here: licenseId, name.

    Example: licenseId,name

Response

  • licenseIdstringrequired

    Id of the license.

  • namestringrequired

    License name (tier).

Status codes

  • 200Success
  • 401

    Missing or invalid bearer token.

  • 429

    Rate limit exceeded (per token/IP). Transcription uploads may also return code FUP_LIMIT_EXCEEDED or TOO_MANY_CONCURRENT_TRANSCRIPTIONS.

  • 500

    Internal server error.