Mint a provisional anonymous workspace and API key

Zero-human onboarding entry point. Mints a provisional workspace, its org API key, and a seeded shadow-mode default policy — no account, no email. Hard caps: 10 requests per minute, 5 provisional workspaces per network per 24 hours, and an exploration allowance of 50 governed decisions per month. The raw key is returned exactly once. Every dossier a provisional workspace mints carries a SIGNED issuer_context tier of "provisional_anonymous" inside the dossier claims, so a verifier can always distinguish it from an owned org's dossier. Claiming (POST /v1/orgs/{org_id}/claim/start then /claim/verify) attaches a human owner; the key and the dossier ledger survive the claim. The workspace is stamped with what the caller's User-Agent says about where it came from and nothing else: the product and version, and for the open-source runtime's agent-safe-pipeline/<version> (repo=<owner/name>; example=<name>; surface=github) form and Govern's govern/<version> (example=govern@<version>; surface=<runner>; repo=<owner/name>) form, the repository, example and surface. The stamp is accounting for the acquisition funnel; it is never decision input and never verified.

post/v1/public/agents/provision

Request

  • Base URL: https://api.decionis.com
  • URL: https://api.decionis.com/v1/public/agents/provision
  • Auth: none required

Request body

agent_namestring

Optional display name for the workspace, shown to the claiming owner.

Response

Provisional workspace minted; the raw key appears only here

org_idstring uuid required
raw_keystring required

The workspace's org API key. Returned exactly once — store it.

provisionalboolean required

Always true at mint; the workspace stays provisional until claimed.

claimobject required

How to attach a human owner — the claim/start and claim/verify endpoints prefilled for this org, plus the note to surface to your operator. The key and dossier ledger survive the claim.

nextobject required

Suggested next calls, starting with a shadow-mode evaluate-decision.

Example response

{
  "limits": {
    "requests_per_minute": 10,
    "workspaces_per_network_per_day": 5,
    "governed_decisions_per_month": 50
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.