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

# anaconda org auth

export const GCell = ({children, className}) => <div className={`grid-table-cell ${className || ""}`} role="cell">
    {children}
  </div>;

export const GTH = ({children, className}) => <div className={`grid-table-th ${className || ""}`} role="columnheader">
    {children}
  </div>;

export const GRow = ({children}) => <div className="grid-table-row" role="row">{children}</div>;

export const GBody = ({children}) => <div className="grid-table-body" role="rowgroup">{children}</div>;

export const GHead = ({children}) => <div className="grid-table-head" role="rowgroup">{children}</div>;

export const GTable = ({children, className, cols}) => <div className={`grid-table not-prose overflow-hidden rounded-2xl ${className || ""}`} style={{
  "--grid-table-cols": cols
}} role="table">
    {children}
  </div>;

## Usage

```bash theme={null}
anaconda org auth <ACTIONS> [OPTIONS]
```

<Comments>
  Replace \<ACTIONS> with one of the actions listed below.
</Comments>

## Description

Manages authorization tokens for the Anaconda API. Tokens provide scoped access for CI/CD pipelines, automated uploads, and other non-interactive workflows. Exactly one action must be specified.

For documentation for the `anaconda-auth` command library, see the [anaconda-auth CLI reference](/cli-reference/anaconda-auth/getting-started).

<Note>
  This command manages API authorization tokens, which are different from the session credentials stored by `anaconda login`. Use `anaconda auth --create` to generate tokens for automation and `anaconda login` for interactive sessions.
</Note>

## Actions

<GTable cols="40% 60%">
  <GHead>
    <GRow>
      <GTH>Action</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`--create`</GCell>
      <GCell>Create a new authorization token</GCell>
    </GRow>

    <GRow>
      <GCell>`--list`</GCell>
      <GCell>List all authorization tokens</GCell>
    </GRow>

    <GRow>
      <GCell>`--remove <TOKEN_ID>`</GCell>
      <GCell>Remove one or more authorization tokens</GCell>
    </GRow>

    <GRow>
      <GCell>`--info`</GCell>
      <GCell>Show information about the current token</GCell>
    </GRow>

    <GRow>
      <GCell>`--list-scopes`</GCell>
      <GCell>List all available scopes</GCell>
    </GRow>
  </GBody>
</GTable>

## Options

<GTable cols="25% 30% 45%">
  <GHead>
    <GRow>
      <GTH>Option</GTH>
      <GTH>Default</GTH>
      <GTH>Description</GTH>
    </GRow>
  </GHead>

  <GBody>
    <GRow>
      <GCell>`-n, --name <NAME>`</GCell>
      <GCell>`binstar_token:<hostname>`</GCell>
      <GCell>Name for the token</GCell>
    </GRow>

    <GRow>
      <GCell>`-o, --org <ORGANIZATION>`</GCell>

      <GCell />

      <GCell>Set the token owner to an organization</GCell>
    </GRow>

    <GRow>
      <GCell>`--strength <STRENGTH>`</GCell>
      <GCell>`strong`</GCell>
      <GCell>Token strength: `strong` or `weak`</GCell>
    </GRow>

    <GRow>
      <GCell>`-s, --scopes <SCOPE>`</GCell>

      <GCell />

      <GCell>Scopes for the token (can be specified multiple times)</GCell>
    </GRow>

    <GRow>
      <GCell>`--url <URL>`</GCell>
      <GCell>`http://anaconda.org`</GCell>
      <GCell>Application URL for the token</GCell>
    </GRow>

    <GRow>
      <GCell>`--max-age <SECONDS>`</GCell>

      <GCell />

      <GCell>Maximum age of the token in seconds</GCell>
    </GRow>

    <GRow>
      <GCell>`--out <FILE>`</GCell>
      <GCell>stdout</GCell>
      <GCell>Output file for the token</GCell>
    </GRow>

    <GRow>
      <GCell>`-h`</GCell>

      <GCell />

      <GCell>Show help for this command</GCell>
    </GRow>
  </GBody>
</GTable>

## Examples

**List available scopes**

```bash theme={null}
anaconda org auth --list-scopes
```

**Create a token with specific scopes**

```bash theme={null}
anaconda org auth --create --name my-ci-token --scopes "repos conda:download"
```

**List all tokens**

```bash theme={null}
anaconda org auth --list
```

**Show information about the current token**

```bash theme={null}
anaconda org auth --info
```

**Remove a token**

```bash theme={null}
anaconda org auth --remove my-ci-token
```

**Create an organization token**

```bash theme={null}
anaconda org auth --create --org my-org --name org-ci-token
```

**Create an organization token with repository access**

```bash theme={null}
anaconda org auth --create --org my-org --name org-ci-token --scopes "repos"
```

**Create a short-lived token**

```bash theme={null}
anaconda org auth --create --name short-lived-token --max-age 3600
```