# llms.txt — agent index for the homeserver at https://matrix.gdna.ai

> Client-server reference for matrix.gdna.ai. Every page describes only routes this build registers. Public, no access token.

The HTML page is https://matrix.gdna.ai/docs. User IDs are @localpart:matrix.gdna.ai. SSO is Keycloak at auth.gdna.io (m.login.sso, then m.login.token). Access tokens last 24 hours and cannot be refreshed.

## Docs

- [Overview](https://matrix.gdna.ai/docs/index.md): Base URL, server name, user IDs, and the table of contents
- [Server discovery](https://matrix.gdna.ai/docs/discovery.md): .well-known, /versions, federation port
- [Authentication](https://matrix.gdna.ai/docs/auth.md): SSO redirect, loginToken exchange, bearer tokens, logout
- [Sync](https://matrix.gdna.ai/docs/sync.md): initial sync, long-poll, what /sync does not filter
- [Sending and receiving](https://matrix.gdna.ai/docs/messages.md): send, history, context, relations
- [Rooms](https://matrix.gdna.ai/docs/rooms.md): create, join, leave, invite, aliases
- [Media](https://matrix.gdna.ai/docs/media.md): upload, download, authenticated media; previews are not supported
- [End-to-end encryption](https://matrix.gdna.ai/docs/e2ee.md): device keys, cross-signing, to-device, key backup
- [Endpoint reference](https://matrix.gdna.ai/docs/reference.md): method, path, and auth for every registered route
- [Rate limits and errors](https://matrix.gdna.ai/docs/limits.md): token buckets and errcode values
- [Federation](https://matrix.gdna.ai/docs/federation.md): matrix.gdna.io and matrix.gdna.ai allow-list each other
- [Quickstart](https://matrix.gdna.ai/docs/quickstart.md): curl and matrix-js-sdk for SSO, sync, send, and listen
- [Not supported](https://matrix.gdna.ai/docs/unsupported.md): refresh, hierarchy, sliding sync, open federation, and other refusals