OneOS Docs
Genesis 0.1.13 Console

API reference

Auto

Management for agent organizations: orgs, mandates, approvals and a verifiable decision ledger.

Operations
12
Base path
https://os.one.ml/api/v1/auto
Scopes
auto:read auto:write
API keys
12 tested with an API key
SDK
Not in the SDK
CLI
Not in the CLI
MCP
Not in the MCP server

Operations

OperationEndpointAPI key
List autonomous orgsGET/orgsTested with an API key
Create an autonomous org with a charterPOST/orgsTested with an API key
Get an orgGET/orgs/{org}Tested with an API key
Archive an org and all its mandatesDELETE/orgs/{org}Tested with an API key
Update an org's name, owner or charterPATCH/orgs/{org}Tested with an API key
List an org's approvalsGET/orgs/{org}/approvalsTested with an API key
Record a non-spending decision in the ledgerPOST/orgs/{org}/decisionsTested with an API key
Read an org's decision ledgerGET/orgs/{org}/ledgerTested with an API key
Recompute an org's ledger hash chainGET/orgs/{org}/ledger/verifyTested with an API key
List an org's mandatesGET/orgs/{org}/mandatesTested with an API key
Create a mandatePOST/orgs/{org}/mandatesTested with an API key
Show the identity Auto sees for your credentialGET/whoamiTested with an API key

Orgs

List autonomous orgs

GET/v1/auto/orgs

auto:readTested with an API keyAPI only in 0.1.13auto_listOrgs

Parameters

  • include_archivedquery · string

Responses

curl "https://os.one.ml/api/v1/auto/orgs" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Create an autonomous org with a charter

POST/v1/auto/orgs

auto:writeTested with an API keyAPI only in 0.1.13auto_createOrg

Request body application/json

A JSON object. Its fields are not in the published OpenAPI document.

Responses

curl -X POST "https://os.one.ml/api/v1/auto/orgs" \
  -H "Authorization: Bearer $GENESIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json

Get an org

GET/v1/auto/orgs/{org}

auto:readTested with an API keyAPI only in 0.1.13auto_getOrg

Parameters

  • orgpath · stringrequired

Responses

curl "https://os.one.ml/api/v1/auto/orgs/$ORG" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Archive an org and all its mandates

DELETE/v1/auto/orgs/{org}

auto:writeTested with an API keyAPI only in 0.1.13auto_archiveOrg

Parameters

  • orgpath · stringrequired

Responses

curl -X DELETE "https://os.one.ml/api/v1/auto/orgs/$ORG" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Update an org's name, owner or charter

PATCH/v1/auto/orgs/{org}

auto:writeTested with an API keyAPI only in 0.1.13auto_updateOrg

Parameters

  • orgpath · stringrequired

Request body application/json

A JSON object. Its fields are not in the published OpenAPI document.

Responses

curl -X PATCH "https://os.one.ml/api/v1/auto/orgs/$ORG" \
  -H "Authorization: Bearer $GENESIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json

Approvals

List an org's approvals

GET/v1/auto/orgs/{org}/approvals

auto:readTested with an API keyAPI only in 0.1.13auto_listApprovals

Parameters

  • orgpath · stringrequired
  • statusquery · string

Responses

curl "https://os.one.ml/api/v1/auto/orgs/$ORG/approvals" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Decisions

Record a non-spending decision in the ledger

POST/v1/auto/orgs/{org}/decisions

auto:writeTested with an API keyAPI only in 0.1.13auto_recordDecision

Parameters

  • orgpath · stringrequired

Request body application/json

A JSON object. Its fields are not in the published OpenAPI document.

Responses

curl -X POST "https://os.one.ml/api/v1/auto/orgs/$ORG/decisions" \
  -H "Authorization: Bearer $GENESIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json

Ledger

Read an org's decision ledger

GET/v1/auto/orgs/{org}/ledger

auto:readTested with an API keyAPI only in 0.1.13auto_getLedger

Parameters

  • orgpath · stringrequired
  • afterquery · string
  • limitquery · string

Responses

curl "https://os.one.ml/api/v1/auto/orgs/$ORG/ledger" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Recompute an org's ledger hash chain

GET/v1/auto/orgs/{org}/ledger/verify

auto:readTested with an API keyAPI only in 0.1.13auto_verifyLedger

Parameters

  • orgpath · stringrequired

Responses

curl "https://os.one.ml/api/v1/auto/orgs/$ORG/ledger/verify" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Mandates

List an org's mandates

GET/v1/auto/orgs/{org}/mandates

auto:readTested with an API keyAPI only in 0.1.13auto_listMandates

Parameters

  • orgpath · stringrequired

Responses

curl "https://os.one.ml/api/v1/auto/orgs/$ORG/mandates" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

Create a mandate

POST/v1/auto/orgs/{org}/mandates

auto:writeTested with an API keyAPI only in 0.1.13auto_createMandate

Parameters

  • orgpath · stringrequired

Request body application/json

A JSON object. Its fields are not in the published OpenAPI document.

Responses

curl -X POST "https://os.one.ml/api/v1/auto/orgs/$ORG/mandates" \
  -H "Authorization: Bearer $GENESIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json

Whoami

Show the identity Auto sees for your credential

GET/v1/auto/whoami

auto:readTested with an API keyAPI only in 0.1.13auto_whoami

Responses

curl "https://os.one.ml/api/v1/auto/whoami" \
  -H "Authorization: Bearer $GENESIS_API_KEY"

One Superintelligence, Inc. · Built from Genesis 0.1.13 and the live gateway on 2026-10-20. Support