Skip to main content
POST
Command demo repo

Authorizations

Authorization
string
header
required

Auth0 JWT access token. See Authentication for details.

Path Parameters

repo_id
string<uuid>
required

Body

application/json

A request to take one of the actions a snapshot offered, at the revision the caller read. The action is named by the identifier the snapshot offered it under; a caller can name no state of its own.

schemaVersion
string
required
Allowed value: "bitgo-repo-demo.v1"
actionId
string
required
Pattern: ^[\x21-\x7E]{1,255}$
expectedRevision
string
required
Maximum string length: 20
Pattern: ^(0|[1-9][0-9]*)$
idempotencyKey
string
required

Your key for safe retries, unique within the environment. A retry with the same key and the same request body returns the existing resource with Idempotency-Replayed: true; the same key with a different body answers 409 IDEMPOTENCY_CONFLICT, and a key whose resource recorded no request digest answers 409 IDEMPOTENCY_REPLAY_UNVERIFIABLE. Keys starting with 'match-' are reserved for keys KeyStone derives and are refused.

Required string length: 1 - 255

Response

INSUFFICIENT_SCOPES: the credential lacks the scope, or its identity is not bound to a demo repo actor in its active environment, or the requested view is not granted. SESSION_WRITE_DENIED: a session token on a write. NO_ENVIRONMENT_CONTEXT: a user token without the X-Keystone-Environment header.

A refused request: the rule in words, the machine-readable code and the documentation anchor for it.

detail
string
required

The rule that refused the request, naming no submitted value.

code
enum<string>
required

The machine-readable error code to branch on.

Available options:
INVALID_TOKEN,
TOKEN_EXPIRED,
MISSING_TOKEN,
INSUFFICIENT_SCOPES,
NO_PLATFORM_CONTEXT,
NO_ENVIRONMENT_CONTEXT,
IP_NOT_ALLOWED,
AUTH_CONTEXT_NOT_RESOLVED,
PRINCIPAL_CONFLICT,
USER_TOKEN_REQUIRED,
MISSING_CALLBACK_SIGNATURE,
INVALID_CALLBACK_SIGNATURE,
CALLBACK_AUTH_NOT_CONFIGURED,
SETTLEMENT_NOT_FOUND,
TEMPLATE_NOT_FOUND,
PLATFORM_NOT_FOUND,
ENVIRONMENT_NOT_FOUND,
INSTRUCTION_NOT_FOUND,
WEBHOOK_ENDPOINT_NOT_FOUND,
IP_RANGE_NOT_FOUND,
MEMBER_NOT_FOUND,
PROVIDER_NOT_FOUND,
SESSION_NOT_FOUND,
LEG_NOT_FOUND,
NOT_REPO_SETTLEMENT,
PRINCIPAL_NOT_FOUND,
COMPLIANCE_CHECK_NOT_FOUND,
SESSION_TOKEN_EXPIRED,
SESSION_ESCALATION_DENIED,
SESSION_SETTLEMENT_SCOPE_DENIED,
SESSION_WRITE_DENIED,
DEPOSIT_SECRET_NOT_AVAILABLE,
DEPOSITOR_WALLET_NOT_AVAILABLE,
NO_ESCROW_FOR_CHAIN,
LEG_NOT_DEPOSITABLE,
OFFCHAIN_LEG,
FUNDING_WINDOW_CLOSED,
FUNDING_DEADLINE_PASSED,
LEG_ALREADY_DEPOSITED,
ESCROW_REGISTRATION_MISMATCH,
DUPLICATE_RESOURCE,
IDEMPOTENCY_CONFLICT,
IDEMPOTENCY_REPLAY_UNVERIFIABLE,
SETTLEMENT_STATE_CONFLICT,
NO_VALID_TRANSITION,
SETTLEMENT_BUSY,
INSTRUCTION_NOT_CANCELLABLE,
NOT_REPO_OPEN,
SETTLEMENT_NOT_FINALIZED,
CLOSING_ALREADY_EXISTS,
CLOSING_CREATION_FAILED,
ENVIRONMENT_DEACTIVATED,
PRINCIPAL_NO_LSEG_CASE,
LSEG_TOOLKIT_STALE,
MEMBER_CHANGE_IN_PROGRESS,
VALIDATION_ERROR,
NO_FIELDS_PROVIDED,
INVALID_PARTY_CONFIGURATION,
UNSUPPORTED_CHAIN_COMBINATION,
UNSUPPORTED_SETTLEMENT_CHAIN,
NON_INTEGRAL_QUANTITY,
TEMPLATE_INACTIVE,
UNSUPPORTED_SETTLEMENT_MACHINE,
UNSUPPORTED_SETTLEMENT_MECHANISM,
NO_AUTH0_ORGANIZATION,
SELF_ACTION_FORBIDDEN,
LAST_MEMBER_MANAGER,
INVALID_TARGET_STATE,
CANNOT_RESOLVE_TARGET_STATE,
UNRECOGNIZED_CLIENT,
INVALID_API_VERSION,
RATE_LIMIT_EXCEEDED,
RATE_LIMIT_UNATTRIBUTED,
RATE_LIMIT_CREDENTIAL_ISSUANCE,
AUTH0_ERROR,
EXTERNAL_SERVICE_ERROR,
SCREENING_AUDIT_WRITE_FAILED,
CUSTODY_EXECUTION_UNREADABLE,
HTTP_ERROR
docs_url
string
required

The documentation anchor for the code.

Example:

"https://docs.keystoneos.xyz/guides/error-codes#http-error"