# subagentoutcomes.com — the Outcome primitive

> A durable record of what a session set out to do and whether it did it, generalized directly from Claude Managed Agents' real user.define_outcome event schema and its result enum.

## API
- GET /api/outcomes — list all outcomes, filterable by ?result=
- GET /api/outcomes/:id — fetch one outcome by id
- POST /api/outcomes — create an outcome (gated by OUTCOMES_WRITE_SECRET)
- PATCH /api/outcomes/:id — update an outcome's result (gated by OUTCOMES_WRITE_SECRET)
- GET /api/changes — newest-first change feed (?cursor=&limit=) for polling agents
- POST /mcp — Streamable-HTTP MCP endpoint (initialize / tools/list / tools/call get_outcomes); server card at /.well-known/mcp/server-card.json

## Grounding
The result enum is the doc's own, unmodified: satisfied | needs_revision | max_iterations_reached | failed | interrupted.
Canonical source: https://platform.claude.com/docs/en/managed-agents/define-outcomes.md

## Family
This site is one of the Cloudflare Workers in the subagent*.com family. For the
live, machine-readable directory of every sibling domain, Cloudflare zone ID,
and worker binding, fetch:
https://subagentsubdomains.com/api/dns-zones

For a unified catalog of every API route across every primitive in the family:
https://subagentapi.com/api/catalog