Skip to main content
GET
Get the calling installation

Autorizzazioni

Authorization
string
header
obbligatorio

An integration token, sent as Authorization: Bearer <token>.

A token belongs to one installation of an app. Someone at the property who may manage its integrations installs the app in Gridbeds, under Settings → Integrations, and issues the token there, granting the scopes the app requested or a subset of them. The token is shown once; issuing a new one revokes the previous one.

Every request reads and writes the data of the organization that installed the app, and nothing else. Each operation names the scope it requires. A token without that scope, and the token of an installation that is disabled or in error, are refused with 403; a token that is missing, unknown or revoked, and a user's own sign-in token, are refused with 401.

Risposta

The installation the token belongs to.

data
Installation · object
obbligatorio