orke usage reset-credit

Validate the current account, fetch fresh credits and consume one reset credit. Irreversible; observe usage after failure or response loss before another action.

Command · options · role · examplesEnglish

When to use it

Validate the current account, fetch fresh credits and consume one reset credit. Irreversible; observe usage after failure or response loss before another action.

Syntax

Terminal

orke usage reset-credit --agentId <claude|chatgpt> --runtime <host|isolated> --accountId <string> --revision <string> [--json]

Options

Option	Required	Values and meaning
`--agentId`	Required	Catalog AI ID with a usage probe, such as claude/chatgpt/antigravity `claude\|chatgpt`
`--runtime`	Required	Credential-vault/usage environment: host\|isolated `host\|isolated`
`--accountId`	Required	Managed account ID from agent-account list; not a credential or path `string`
`--revision`	Required	Settings revision from a preceding read; detects concurrent edits `string`

Read common options and errors →

Role and constraints

operator · windows, macos, linux

Requires a running daemon owned by the same OS user; --help never connects.
get/list respect current-account cache and authentication hold. refresh bypasses cache to recheck; other vaults' credentials are not used.

Examples

Terminal

orke usage reset-credit --agentId chatgpt --runtime host --accountId acct-… --revision <revision> --json

Replace example IDs, slugs, revisions, and files with actual observations and inputs.

Response and partial results

{accountId, outcome, usage?} — failed consumption may have executed

Related guidance

Commands in this group →