> ## Documentation Index
> Fetch the complete documentation index at: https://developers.parkes.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Sign in, inspect your identity, and manage personal tokens.

Command syntax for Parkes CLI **0.1.3**. These sections are generated from the command inventory and executable help. See [global options and scripting](https://developers.parkes.ai/cli/SCRIPTING.md) for shared behavior.

## parkes auth login

OAuth authorization-code/PKCE or device grant through standard /oauth endpoints; store credentials in the OS store.

```text theme={null}
Usage: parkes auth login [OPTIONS]

Options:
      --device
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --no-browser
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --reauth
      --no-input
      --scope <SCOPE>      [default: organizations:read integrations:read integrations:write connections:read connections:write skills:read skills:write skills:execute automations:read automations:write automations:execute knowledge:read knowledge:write marketplace:read marketplace:write users:read activity:read models:read]
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth logout

Revoke authorization at /oauth/revoke and delete the OS credential; --all visits all cached accounts.

```text theme={null}
Usage: parkes auth logout [OPTIONS]

Options:
      --all
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth status

Get authenticated identity.

```text theme={null}
Usage: parkes auth status [OPTIONS]

Options:
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth tokens create

Create personal token.

```text theme={null}
Usage: parkes auth tokens create [OPTIONS] --name <NAME> --scope <SCOPE> --output-file <OUTPUT_FILE>

Options:
      --name <NAME>
      --profile <PROFILE>          [env: PARKES_PROFILE=]
      --org <ORG>                  [env: PARKES_ORG=]
      --scope <SCOPE>
      --expires-in <EXPIRES_IN>    [default: 30days]
      --output <OUTPUT>            [possible values: table, json, jsonl]
      --no-input
      --output-file <OUTPUT_FILE>
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>          [default: 30s]
      --color <COLOR>              [default: auto] [possible values: auto, always, never]
  -h, --help                       Print help
```

## parkes auth tokens get

Get personal token.

```text theme={null}
Usage: parkes auth tokens get [OPTIONS] <ID>

Arguments:
  <ID>

Options:
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth tokens list

List personal tokens.

```text theme={null}
Usage: parkes auth tokens list [OPTIONS]

Options:
      --limit <LIMIT>      [default: 50]
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --cursor <CURSOR>
      --org <ORG>          [env: PARKES_ORG=]
      --all
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth tokens revoke

Revoke personal token.

```text theme={null}
Usage: parkes auth tokens revoke [OPTIONS] <ID>

Arguments:
  <ID>

Options:
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```

## parkes auth whoami

Get authenticated identity.

```text theme={null}
Usage: parkes auth whoami [OPTIONS]

Options:
      --profile <PROFILE>  [env: PARKES_PROFILE=]
      --org <ORG>          [env: PARKES_ORG=]
      --output <OUTPUT>    [possible values: table, json, jsonl]
      --no-input
      --yes
      --quiet
      --verbose
      --timeout <TIMEOUT>  [default: 30s]
      --color <COLOR>      [default: auto] [possible values: auto, always, never]
  -h, --help               Print help
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.