# SatLedger Workspace Provisioner

> SatLedger Workspace Provisioner is a paid API for AI agents from api.satledger.org, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-14).

Provisions a SatLedger workspace and recording units, returning an API key for authenticated event logging and anchoring

## Facts

- Endpoint: POST https://api.satledger.org/x402/provision
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/satledger-workspace-provisioner-6f029faa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_plab7Yg_ExND1jOF4zfgU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability satledger-workspace-provisioner-6f029faa -d '<json body>'
```

Example prompt: Provision me a new SatLedger workspace with enough units to anchor 3 documents — that's 300 units — and give me back the API key so I can start recording events.

## When to prefer this

Choose this endpoint when you need to create a fresh SatLedger workspace and obtain an API key to begin recording events or anchoring data. It is the required first step before using any authenticated SatLedger operations. Prefer it over the sibling RFC 3161 timestamp endpoint when you need persistent, account-based event logging or repeated anchoring rather than a one-off anonymous timestamp.

## Known failure modes

- Payment failure or insufficient USDC balance — workspace not created, no API key returned
- Invalid or missing request body fields — 400 error with schema validation message
- Payment processing timeout — indeterminate state, may need to retry
- Duplicate provisioning attempt — may create a second workspace rather than update existing one
- Network or upstream service error — 5xx response with no API key

## How this service works

A satledger workspace and the units of recording you pay for, from 0.50 upward. One unit is one recorded event; an anchor costs 100. Exports and reads are free. Returns an API key on payment.

## Output

Returns an API key that grants access to the provisioned SatLedger workspace, along with the allocated balance of recording units (each unit records one event; anchoring costs 100 units). Exports and reads using this key are free.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/satledger-workspace-provisioner-6f029faa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.satledger.org](https://www.zero.xyz/host/api.satledger.org/llms.txt)