# outcomesdk.com — SDK surface for outcomes

> Quickstart docs for subagentoutcomes.com's live Outcome API — curl and Node examples against the real field names (id, description, rubric_id, max_iterations, result, session_id, source_site, created_at, cite_as), a live sample fetched server-side per render, and the write path documented from the upstream worker's actual handler code. The SDK is the API: there is no published npm package.

## API
- (no API of its own — this site documents subagentoutcomes.com's live API)
- Upstream: GET https://subagentoutcomes.com/api/outcomes — list all outcomes (?result= filter)
- Upstream: GET https://subagentoutcomes.com/api/outcomes/:id — fetch one outcome
- Upstream: POST https://subagentoutcomes.com/api/outcomes — create (gated by OUTCOMES_WRITE_SECRET)
- Upstream: PATCH https://subagentoutcomes.com/api/outcomes/:id — update result only (gated)

## Honest scope note
"The SDK" is documentation of the live API, not a published npm package — nothing to install.
Reads are public and CORS-open; writes require the OUTCOMES_WRITE_SECRET bearer token, which this
docs site does not hold. The result enum is Managed Agents' own five-value user.define_outcome enum
(satisfied | needs_revision | max_iterations_reached | failed | interrupted) plus the upstream
worker's "pending" pre-grading default.

## 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