Skip to main content
POST
Issue a right

Authorizations

Authorization
string
header
required

API key sent as Authorization: Bearer <api-key>.

Body

application/json
basisId
string
required

Id of an existing basis (prefixed bas_).

Example:

"bas_8f2c1a9b4e7d0c63"

substrate
enum<string>
required

Delivery substrate. The platform runtime recognises every value; which ones ship a dedicated client SDK varies (see the substrate readiness matrix). ANY matches all substrates.

Available options:
DOOH,
CTV,
MOBILE,
STREAMING,
AUDIO,
MESSAGING,
GAMING,
GLASSES,
AR_CONTACTS,
HUD,
VOLUMETRIC,
HOLOGRAM,
WEARABLES,
AMBIENT,
NEURAL,
AUTOMOTIVE,
SMART_HOME,
ROBOTICS,
DRONE,
SATELLITE,
AVIATION,
MARITIME,
SOCIAL_FEED,
ANY
scope
string
required

Free-form scope label for the right.

Minimum string length: 1
Example:

"DOOH retail estate, Greater London"

effectiveFrom
string<date-time>
required
effectiveUntil
string<date-time> | null

Optional; defaults to null. Must not predate effectiveFrom.

Response

The issued right.

ok
boolean
required
data
object
required

Route-specific payload. Operation responses refine this.

contractVersion
string
required
Allowed value: "v1.0"