---
title: Synorb safe test path
description: Validate request shape and scope with Synorb's zero-usage plan preview — no key required.
canonical: https://synorb.com/sandbox
last-updated: 2026-09-20
---

# Synorb safe test path

This is Synorb's canonical sandbox/test documentation entry point. It is not
a separate account or isolated data environment: Synorb does not currently
offer a separate sandbox host.

## Non-mutating test — no key required

Discovery, search, and the plan preview never touch billable Manifest
content, so they work with no Synorb Key at all. Only an actual Manifest
pull (POST /manifests/query in its default mode, or POST /manifests/exec)
requires one — that is the only thing that bills usage.

    curl -sS -X POST https://api.synorb.com/manifests/plan \
      -H "Content-Type: application/json" \
      -d '{"stream_ids":["STREAM_ID"],"page_size":1}'

POST /manifests/plan is a zero-usage preview. It does not return Manifests,
does not bill Manifest usage allowance, and does not mutate account data. Anonymous
calls are rate-limited by IP; add `Authorization: Bearer $SYNORB_KEY` for a
higher per-org limit and a plan_token you can actually execute — an
anonymously-issued plan_token cannot be redeemed at POST /manifests/exec,
since execution always requires a real, authenticated org.

Stream/source discovery is also keyless:

    curl -sS -X POST https://api.synorb.com/streams/search \
      -H "Content-Type: application/json" \
      -d '{"query":"central bank policy"}'

An OAuth 2.0 access token (see [synorb.com/auth](https://synorb.com/auth)) works identically to a Synorb Key as the `Authorization: Bearer` value everywhere on this page.

## Get a free key

Send POST https://api.synorb.com/api/connect/demo-key with the body
`{"client": "<your agent name>"}` to self-serve a 72 Hour Agent Demo key without an
email or card. A person can click Generate Free Agent Key on
https://synorb.com/connect/start. Use it once you're ready to actually pull Manifest
content, or want the higher rate limit on discovery calls.

- [Connect](https://synorb.com/connect/start)
- [API docs](https://synorb.com/docs)
- [OpenAPI contract](https://synorb.com/openapi.json)