SIsignadot
Devboxes

Register a devbox (idempotent POST)

Changed on

Register a devbox with metadata. Returns 201 Created for new devbox, 200 OK if already exists. When authenticated via API key, creates org-scoped devboxes shared across all API keys in the org.

post/orgs/{orgName}/devboxes/

Request

  • Base URL
    https://api.signadot.com/api/v2
  • Auth
    none declared

Path parameters

orgNamestring required

Signadot Org Name

Request body

claimboolean
metadataobject

Required: metadata key-value pairs. Only "name" and "machine-id" are used for ID generation.

Response

OK

idstring

Deterministic ID derived from the owning principal + metadata ("name"/"machine-id").

metadataobject

Only "name" and "machine-id" are used for ID generation.

userstring

DEPRECATED: owner email for User-owned devboxes, empty otherwise; use principal instead.

Changes