Skip to main content
POST
/
v1
/
rights
/
issue
Issue a right
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    basisId: 'bas_8f2c1a9b4e7d0c63',
    scope: 'DOOH retail estate, Greater London',
    effectiveFrom: '2023-11-07T05:31:56Z',
    effectiveUntil: '2023-11-07T05:31:56Z'
  })
};

fetch('https://sandbox.api.enfinitos.com/v1/rights/issue', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "ok": true,
  "data": {
    "right": {
      "id": "<string>",
      "orgId": "<string>",
      "basisId": "<string>",
      "parentRightId": "<string>",
      "scope": "<string>",
      "effectiveFrom": "2023-11-07T05:31:56Z",
      "effectiveUntil": "2023-11-07T05:31:56Z",
      "contentHash": "<string>",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  },
  "contractVersion": "<string>"
}

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"