Project Actors

Project actors are headless users, such as pipeline jobs, that need to interact with a Constellation but aren’t actual users. You can manage actors by opening your project and pressing the robot icon. From this view you can create and delete actors. Each actor will have a set of permissions and a name. When creating the actors you’ll be given the chance to copy its access token which can be used to make calls to the konstellat.io API. You only need the access token when making API calls; the name is to help keep actors organized in your project and will be used in stamps. After the expiration date, the actor will be automatically deleted from your project.

To make API calls using an actor, you pass the actor’s access token as a bearer token in the HTTP authorization header.

HTTPS GET

GET /api/v1/project/{{projectId}}/revision HTTP/1.1
Host: api.konstellat.io
Authorization: Bearer <access token>

Caution

The actor’s access token will only be shown once when created and then removed. So if you lose the access token you’ll have to create a new actor and replace any secrets that contain the old access token.