API Keys
API keys allow you to authenticate with the Paquetier API and CLI without using your username and password. They are essential for CI/CD pipelines and automated workflows.
Creating an API Key
- Navigate to Credentials > API Keys in the sidebar.
- Click New Key.
- Configure the key:
- Name — A descriptive name (e.g. “CI pipeline”, “local dev”).
- Role — The permission level for this key (
admin,write, orread). Areadkey cannot change anything, uploads included, even when its owner could. - Scope — Restrict the key to a specific repository, or allow access to all repositories.
- Click Create Key.
:::caution Copy the generated key immediately. It will not be shown again. :::
Key Format
All API keys are prefixed with paquetier_ for easy identification.
For example: paquetier_abc123def456...
Using API Keys
With the CLI
With the API
Pass the key in the Authorization header:
With R (Private Repos)
With pip, uv, Poetry and twine
Python tools send the key as the password, with __token__ as the user name; see Python Packages.
Keys Creating Keys
A request authenticated with an API key, such as a CI job, can create further keys, but none that reach further than its own: no broader role, and for a key scoped to a repository, no other repository.
Managing Keys
- Keys can be deleted from the API Keys page.
- Deletion is immediate and cannot be undone.
- The Last Used column shows when each key was last used for authentication.
