Creating an access token

To interact with the Taskurai API, you need to create a personal access token (PAT).

To create a PAT, run the following command:

taskurai pat create --name mytoken --valid-minutes 43200 --scopes "Data/Buildby.Taskurai/*"

The result of this command should be similar to the following:

# Signed into Taskurai

mytoken
├── General
│   └── ╭─────────┬───────────────┬───────────┬──────────╮
│       │ Name    │ Valid Minutes │ Unlimited │ Modified │
│       ├─────────┼───────────────┼───────────┼──────────┤
│       │ mytoken │ 43200         │ false     │ null     │
│       ╰─────────┴───────────────┴───────────┴──────────╯
└── Scopes
    └── ╭─────────────────────────╮
        │ Scopes                  │
        ├─────────────────────────┤
        │ Data/Buildby.Taskurai/* │
        ╰─────────────────────────╯


# Succesfully created personal access token mytoken.
                                           
This token will only be displayed once. Copy the token to a secure place, do not share this token, do not check this token into source control.
                                           

e8gFaA8ZaetAHiS257opAr...

caution

This token grants access to the Taskurai API.

Copy the token to a secure place and do not share or check this token into source control.

It is recommended to only assigned the minimal required scope to the token, see Personal access tokens for more information.