Skip to Content
OpenETL
ReferenceAPIAccess Service

Get caller

Who is calling, and what they may do. Any credential may ask.

GET
/v1/caller

Who is calling, and what they may do. Any credential may ask.

Query Parameters

workspace?string

workspaces/{workspace}, for the permissions held there. Empty: those on the org.

Response Body

OK

application/json
  1. response
principal?

A user or a service account, which calls the API with its keys.

credential?string

principals/{principal}/keys/{key} or principals/{principal}/sessions/{session}. Empty when sign-in is off and the call had no credential.

expireTime?string

When the credential stops working unless it's used, for a session; unset for a key that doesn't expire.

Formatdate-time
permissions?array<string>

What the caller may do in the workspace, or on the org: permissions such as pipelines.sync.

authless?boolean

Sign-in is off (openetld --auth none), so calls without a credential act as principals/local, an owner.

Example Request
curl -X GET 'http://localhost:8080/v1/caller'
Example Response
{  "principal": {    "name": "string",    "type": "PRINCIPAL_TYPE_UNSPECIFIED",    "displayName": "string",    "email": "string",    "disabled": true,    "roleBindings": [      {        "role": "ROLE_UNSPECIFIED",        "workspace": "string"      }    ],    "createTime": "2019-08-24T14:15:22Z"  },  "credential": "string",  "expireTime": "2019-08-24T14:15:22Z",  "permissions": [    "string"  ],  "authless": true}