Skip to main content
POST
Verify a public VM image

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
connectionId
string
required
Required string length: 1 - 200
image
string
required
Required string length: 1 - 512
Pattern: ^(?:(?:[A-Za-z0-9]+(?:[._-][A-Za-z0-9]+)*\/)?[A-Za-z0-9]+(?:[._-][A-Za-z0-9]+)*(?:\/[A-Za-z0-9]+(?:[._-][A-Za-z0-9]+)*)*(?::[A-Za-z0-9_][A-Za-z0-9_.-]{0,127})?(?:@sha256:[a-f0-9]{64})?)$
tags
string[]
required
Maximum array length: 20
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$
agentKind
enum<string>
required
Available options:
codex,
claude,
pi

Response

Verification operation

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
status
enum<string>
required
Available options:
queued,
creating,
checking_ssh,
checking_agent,
cleaning_up,
succeeded,
failed,
cleanup_failed
phase
string
required
errorKind
string | null
required
error
string | null
required
createdAt
string
required
updatedAt
string
required