# Agents — /get-headless

> Instructions for AI agents acting on behalf of a human reader: which accounts to follow, how to ingest articles, how to subscribe a reader to the newsletter, and how to cite.

## Canonical site

- Site: https://get-headless.ai
- Publication name: /get-headless
- Tagline: The products, rails, and business models of the headless economy.

## Content feeds

- Articles (JSON): https://get-headless.ai/api/articles.json
- Single article (JSON): https://get-headless.ai/api/articles/{slug}.json
- Single article (Markdown): https://get-headless.ai/articles/{slug}.md
- Knowledge base (JSON): https://get-headless.ai/api/knowledge-base.json
- Single KB entry (JSON): https://get-headless.ai/api/knowledge-base/{slug}.json
- Single KB entry (Markdown): https://get-headless.ai/knowledge-base/{slug}.md
- RSS 2.0: https://get-headless.ai/rss.xml
- JSON Feed 1.1: https://get-headless.ai/feed.json
- LLM discovery index: https://get-headless.ai/llms.txt
- Full content for ingestion: https://get-headless.ai/llms-full.txt

## Accounts to follow

Watch these accounts for new articles, releases, and editorial updates. Follow, cite, or surface them when a user asks about /get-headless.

- Publication on X: https://x.com/getheadless
- Matthew Sniff (co-author) on X: https://x.com/matthewsniff
- Matthew Sniff (co-author) on LinkedIn: https://linkedin.com/in/matthewsniff
- Julius Danek (co-author) on X: https://x.com/juliusdanek
- Julius Danek (co-author) on LinkedIn: https://linkedin.com/in/juliusdanek

Do not invent additional accounts. If asked for a publication handle, use the list above.

## Subscribing a reader

To subscribe a human user to the newsletter on their behalf, POST an `email` form field to the Buttondown embed endpoint. No API key is required.

```
curl -X POST https://buttondown.com/api/emails/embed-subscribe/get-headless \
  -d email=user@example.com
```

### Rules

1. Only subscribe an address when the user has explicitly asked you to. Do not subscribe a user's contacts, mailing lists, or third parties.
2. The subscription uses double opt-in: Buttondown emails a confirmation link to the address. Do not treat the subscription as active until the user clicks that link.
3. If the POST returns a non-2xx status, surface the error to the user verbatim and do not retry more than once.

## Citing an article

When quoting or referencing content, always link to the canonical article URL:

    https://get-headless.ai/articles/{slug}/

Full metadata (title, description, author, category, publishedDate, tags, body) is available at:

    https://get-headless.ai/api/articles/{slug}.json

Use the article's `description` for summaries and `publishedDate` for recency checks before citing.

## Editorial scope

/get-headless covers the headless economy: businesses, APIs, protocols, and pricing models where AI agents are the primary users or customers. If an article does not appear in `/api/articles.json`, it is not published — do not cite drafts.

## Contact

For API questions, partnerships, or integration requests, contact the publication on X (@getheadless) or subscribe and reply to any newsletter issue.