# nodus create apikey

> Create an API key (printed once)

Source: https://nodus-platform-site.pages.dev/docs/reference/cli/nodus_create_apikey/
Build revision: 211ad9f836655b1c3a2668c4693e442471f28614

## nodus create apikey

Create an API key (printed once)

```plaintext
nodus create apikey NAME [flags]
```

### Examples

```plaintext
  nodus create apikey ci --scopes jobs:write,volumes:read --projects research --expires 720h
```

### Options

```plaintext
      --description string          What the key is for (at most 256 characters)
      --dry-run string[="server"]   server returns the estimate without creating; client prints the manifest (default "none")
      --expires string              Lifetime of the key, such as 720h (default: it does not expire)
  -h, --help                        help for apikey
  -o, --output string               Output format: name, json, yaml, or estimate (with --dry-run=server)
      --projects strings            Projects the key may reach, comma-separated or repeated (default: all)
      --scopes strings              Scopes such as jobs:write, comma-separated or repeated (default: whatever your role allows)
      --service-account string      Bind the key to this ServiceAccount of the project (-p)
```

### Options inherited from parent commands

```plaintext
      --context string   Context from the config file to use
      --org string       Organization (selects the context for that org)
  -p, --project string   Project to work in
  -v, --verbose          Log each API request (never credentials)
```

### SEE ALSO

* [nodus create](https://nodus-platform-site.pages.dev/docs/reference/cli/nodus_create/) - Create resources from manifests or with a typed generator

### Tested examples

These invocations run in CI against the CLI’s fake API.

Terminal window

```sh
nodus create apikey ci --scopes jobs:write,volumes:read --projects research --expires 720h
nodus create apikey ci2 -o name
nodus create apikey bot --service-account deploy --dry-run=client
```