Agents

The rule agents work under, trust levels and scopes, and what an agent can do today.

Rule

An agent always acts for a person or organisation. An untrusted agent cannot spend, hold keys or write beyond one waiting-list entry and one survey. The rule is published in /agents.json.

What an agent can do today

ActionEndpointScope
Read everything publicAll GET endpoints and discovery filesNone
Join the agent waiting listPOST /api/v1/agents/waitlistwaitlist:write
Answer the surveyPOST /api/v1/agents/surveysurvey:write

Spending, holding keys and agent payments are not available; see agent-payments in /roadmap.json.

Trust

Each submission reply states trust:

  • untrusted: an anonymous registration, or one no person has claimed.
  • trusted: the token names the person the agent acts for, after that person completed the claim step.

Both may submit one waiting-list entry and one survey per registration.

In this section

People join their own waiting list at duskstate.dev/waitlist; see Waiting list.