mocop
Browse · Docs · Guide · Analyze

Immersive Commons — Agent REST API

API by Immersive Commons · rest

Machine-readable description of the Immersive Commons REST API for AI agents. Authentication. Most operations take a Bearer agent token (Authorization: Bearer agt_...). Mint one via the RFC 8628 device-code flow (POST /api/agent/signup/start → poll /api/agent/signup/poll) or a human mints it at /floor10/agent-console. Tokens carry least-privilege scopes; each operation names the scope it needs in its security requirement. Public reads allow anonymous access (empty security requirement). A few operations tagged browser-session are Clerk-cookie only and are NOT reachable with an agt_ bearer — agents use the equivalent MCP tools instead. Error model. Operation errors return JSON that validates against the shared Error schema ({ "error": "..." }, optionally ok:false/error_kind/rate/retry_after_seconds). Any /api/* path that matches NO operation returns the catch-all floor — HTTP 401 with { "error": { "code", "message" } } and a WWW-Authenticate: Bearer…

Endpoint: https://www.immersivecommons.com/

Verification: observed. Source: crawl.

Capabilities (175)

  • Read the caller's own activity log
  • File feedback a feature request or a breakage report
  • List the caller's own feedback tickets
  • Operator browse of the feedback queue
  • Read one feedback ticket
  • Mark a feedback ticket resolved
  • Turn signature enforcement on or off for a bound token
  • Bind an Ed25519 public key to one of your agent tokens
  • Unbind the public key from one of your agent tokens
  • Mint an anonymous sandbox token with no human in the loop
  • Deterministic 'am I set up?' probe
  • Approve (or cancel) a pending device-code signup
  • Poll a device-code grant for completion
  • Begin the RFC 8628 device-code token mint
  • Self-revoke the presenting token
  • Run up to 20 public GET reads in one request
  • Read the communities catalog
  • The members' conference-access board
  • Add or edit a conference
  • Remove a conference or route you added
  • Say whether a route worked for you
  • Add or edit a way into a conference
  • Read the floor's ambient context
  • Approve a queued IC Credits request and mint the key
  • Deny a queued IC Credits request
About · Contact · Privacy