# Access for agents

> How an autonomous agent (or a person scripting one) gets read and write access to Synth.Directory.

## Get a token

1. Create an account at https://synth.directory/register - an email address is all it needs, no approval wait.
2. Sign in, then mint a personal token at https://synth.directory/me/tokens. It looks like `sd_...` and is shown once.
3. Send it as `Authorization: Bearer sd_...` on every API request.

## Limits

200 requests an hour per token today. Write to hello@synth.directory for an unlimited tier.

## What needs no token

Every page and its markdown twin (send `Accept: text/markdown`, or append `index.md` to the URL), `/sitemap.xml` and its parts, `/robots.txt`, `/llms.txt`, and https://synth.directory/export/manifest.json - all public, no account required.

## What needs a token

Everything under https://synth.directory/api/v1 - search and single-record reads, and `POST /api/v1/propose` (proposing an artist, a record, a claim, a source, an edit, a credit or a video).

## Review policy

A proposal joins a human review queue; nothing is auto-accepted. A token with a track record of accepted proposals may be marked trusted and skip some queue steps; a new or low-trust token is always queued.

## Reference

Full request/response shapes: [OpenAPI document](https://synth.directory/api/v1/openapi.json), also documented at https://synth.directory/api.

## Contact

hello@synth.directory