API Documentation

Learn how to publish your lexicon schemas to the AT Protocol Schema Registry and integrate with the indexing API.

Overview

Lexicon Store is a public registry for AT Protocol lexicon schemas. It automatically indexes schemas published to the network and provides a searchable interface for discovery.

There are two ways to get your lexicons indexed:

Automatic indexing - Publish lexicons to your PDS and they'll be discovered automatically
Request indexing - Use the API to request immediate indexing of specific lexicons

API Endpoints

POST https://api.lexicon.store/requestIndex

Queue a lexicon for indexing. DNS authority verification is performed automatically.

Request Body

{
  "type": "nsid" | "did" | "domain",
  "value": "string"
}

Parameters

nsid - Index a specific lexicon (e.g., app.bsky.feed.post)
did - Index all lexicons from a DID (e.g., did:plc:xyz...)
domain - Index all lexicons from a domain (e.g., bsky.app)

Example

curl -X POST https://api.lexicon.store/requestIndex \
  -H "Content-Type: application/json" \
  -d '{"type": "nsid", "value": "com.example.myLexicon"}'

Response

{
  "success": true,
  "message": "Queued for indexing"
}

DNS Authority Verification

For a lexicon to be indexed, the publisher must have authority over the NSID namespace. This is verified through DNS:

The NSID com.example.myLexicon requires authority over example.com
Add a DNS TXT record: _atproto.example.com pointing to your DID
Or use a did:web identifier that matches the domain

Viewing Your Lexicons

Once indexed, your lexicons will appear in the registry and can be viewed at:

Registry: lexicon.store
PDSLS: https://pdsls.dev/at://did:web:lexicon.store/com.atproto.lexicon.schema/{nsid}
ATPI: https://atpi.at://did:web:lexicon.store/com.atproto.lexicon.schema/{nsid}

Additional Resources

Learn more about publishing lexicons: