registry
registry delete
Remove a private registry credential.
destructiverepeatable--dry-run
Removes a stored login. The password is not recoverable, so restoring one means having the original somewhere else.
Nothing breaks at the moment of deletion. An application already running keeps its image, and the failure appears at the next deployment that has to pull.
Usage
outplane registry delete <CREDENTIAL> [flags]Arguments
| Argument | Type | Description |
|---|---|---|
CREDENTIAL | string | Name or id. Required. |
Flags
| Flag | Type | Description |
|---|---|---|
-y, --yes | bool | Acknowledge the removal. Not sufficient on its own. |
--confirm-name | string | The credential's name, repeated. Guards against deleting the wrong one. |
The global flags apply as well.
Output
| Field | Type | Description |
|---|---|---|
id | string | |
name | string | What this credential is called here. |
server | string | The registry's host, such as ghcr.io. Not a URL and not an image reference. |
username | string | |
createdAt | string | null | RFC 3339, UTC. |
changed | bool | False for a dry run. |
Examples
Check what the name resolves to, before confirming
outplane registry delete ghcr --dry-run --json{
"changed": false,
"name": "ghcr",
"server": "ghcr.io"
}Request removal. Returns exit 4 with a command to replay
outplane registry delete ghcrThe confirmed form
outplane registry delete ghcr --yes --confirm-name ghcrWhat to Know
- Refused under an agent harness, exit 4 with confirmation.required, whatever flags are given. The error carries the exact command a person would run.
- Outside a harness, both --yes and --confirm-name are required, and --confirm-name has to match the credential's name exactly.
- The password is not recoverable. Restoring this means having the original somewhere else.
- Nothing breaks immediately. An application already running keeps its image; the failure appears at the next deployment that has to pull.
Errors
Beyond 0 for success, this command exits with:
| Exit | Kind | Meaning |
|---|---|---|
2 | usage | Invalid arguments, unknown flag, or client-side validation failure. |
3 | auth | Not authenticated, token revoked or expired, or forbidden for this team. |
4 | confirmation_required | A destructive operation stopped. Replay the command in confirm_command. |
5 | not_found | The named resource does not exist, or is not visible to this credential. |
8 | upstream | The Out Plane API returned a server error. |
The code on the error object is one of registry.not_found, registry.confirm_name_mismatch, confirmation.required, usage.missing_argument, context.no_team. Branch on that, or on the exit status. The message is prose and changes.