Skip to content
Spinbox is experimental: APIs change and data may be lost. Status lists what is built and what proves it.

PasskeyService

View Markdown

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.

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

FieldTypeWhat it is
purposePasskeyPurpose
subjectstring

Response

FieldTypeWhat it is
challengestring (byte)
rpIdstringThe relying party a credential is made for and asserted under: the installation’s base domain.
credentialIdslist of string (byte)The caller’s passkeys’ credential ids, for an assertion’s allowCredentials.

POST /spin.v1.PasskeyService/DeletePasskey

Deletes a passkey of the caller’s, with an assertion of one of theirs.

Request

FieldTypeWhat it is
idstring
stepUpPasskeyAssertion

Response

No fields: {}.

POST /spin.v1.PasskeyService/ListPasskeys

Request

No fields: {}.

Response

FieldTypeWhat it is
passkeyslist of Passkey

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

FieldTypeWhat it is
namestring
challengestring (byte)
credentialIdstring (byte)
clientDataJsonstring (byte)
authenticatorDatastring (byte)
publicKeystring (byte)The credential’s public key, SubjectPublicKeyInfo (AuthenticatorAttestationResponse.getPublicKey).
stepUpPasskeyAssertionAn assertion of a passkey the account has, over a PASSKEY_PURPOSE_ADD_PASSKEY challenge naming this credential; unset for the account’s first.

Response

FieldTypeWhat it is
passkeyPasskey

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.