PasskeyService
PasskeyService is a person’s passkeys: WebAuthn credentials of their account, under the. installation’s base domain (internal/passkey). A passkey signs a challenge the control plane. issued, never a document: what turns a session into a key that logs in (SSHKeyService.AddSSHKey) is an assertion of one, so a session alone - stolen, or an agent’s - is no shell.
BeginPasskeyCeremony
Section titled “BeginPasskeyCeremony”POST /spin.v1.PasskeyService/BeginPasskeyCeremony
A challenge for one ceremony of the caller’s, bound to what it is for: a passkey registered, a key added, a passkey deleted. Taken once, by the call it is answered in, within minutes.
Request
| Field | Type | What it is |
|---|---|---|
purpose | PasskeyPurpose | |
subject | string |
Response
| Field | Type | What it is |
|---|---|---|
challenge | string (byte) | |
rpId | string | The relying party a credential is made for and asserted under: the installation’s base domain. |
credentialIds | list of string (byte) | The caller’s passkeys’ credential ids, for an assertion’s allowCredentials. |
DeletePasskey
Section titled “DeletePasskey”POST /spin.v1.PasskeyService/DeletePasskey
Deletes a passkey of the caller’s, with an assertion of one of theirs.
Request
| Field | Type | What it is |
|---|---|---|
id | string | |
stepUp | PasskeyAssertion |
Response
No fields: {}.
ListPasskeys
Section titled “ListPasskeys”POST /spin.v1.PasskeyService/ListPasskeys
Request
No fields: {}.
Response
| Field | Type | What it is |
|---|---|---|
passkeys | list of Passkey |
RegisterPasskey
Section titled “RegisterPasskey”POST /spin.v1.PasskeyService/RegisterPasskey
Registers a passkey to the caller’s account. The first is registered on their session alone; another takes an assertion of one they have, so a session cannot add a passkey of its own.
Request
| Field | Type | What it is |
|---|---|---|
name | string | |
challenge | string (byte) | |
credentialId | string (byte) | |
clientDataJson | string (byte) | |
authenticatorData | string (byte) | |
publicKey | string (byte) | The credential’s public key, SubjectPublicKeyInfo (AuthenticatorAttestationResponse.getPublicKey). |
stepUp | PasskeyAssertion | An assertion of a passkey the account has, over a PASSKEY_PURPOSE_ADD_PASSKEY challenge naming this credential; unset for the account’s first. |
Response
| Field | Type | What it is |
|---|---|---|
passkey | Passkey |
Generated by task reference from spin/internal/controlplane/apidocs/spin.v1.openapi.json at 51f7e0dea.
Installations run Spinbox v20261027.01; the reference is generated from spin v20261114.01 (51f7e0dea). This page as Markdown, for a model or a terminal.

