Account

Get the calling service account

Returns the identity of the service account that owns the access token used for this request. Use it to confirm that a token works and to see which scopes and nodes it can reach. Any valid access token is accepted, whatever scopes it grants. Node access is re-read on every request, so a change to the nodes takes effect on the next call. Scopes are fixed when the token is issued: request a new token to pick up a newly granted scope. Removing a scope, revoking the account or rotating its credentials invalidates existing tokens immediately. scopes lists what this token grants, which can be fewer than the account holds. business_node_ids lists the nodes the account can read. An empty list means the account can read nothing. The response is never cached.

get/me

Response

OK

business_idstring

identifier of your organization

business_node_idsstring[]

identifiers of the nodes in your organization's hierarchy this account can read; empty means none

caller_type'service_account'

always "service_account"

client_idstring

the OAuth client_id used to request tokens

idstring

unique identifier of the service account

namestring

the name given to the service account

scopesstring[]

scopes granted to this token, for example items:read

Example response

{
  "caller_type": "service_account"
}

Changes

Changed in 1 of the 12 revisions of this API.1