> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rray.app/docs/concepts/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rray.app/_mcp/server.

# Concepts

## Docs

- [Credentials](https://docs.rray.app/docs/concepts/authentication.md): The two kinds of key, and the headers that bind them to a workspace
- [Workspaces](https://docs.rray.app/docs/concepts/workspaces.md): The sending tenant every message belongs to
- [Message lifecycle](https://docs.rray.app/docs/concepts/message-lifecycle.md): From accepted to a terminal outcome, and how to read the timeline
- [Rate limits](https://docs.rray.app/docs/concepts/rate-limits.md): Fixed per-minute windows, the headers that report them, and how to back off
- [Errors](https://docs.rray.app/docs/concepts/errors.md): RFC 9457 problem details with stable machine-readable codes
- [Idempotency](https://docs.rray.app/docs/concepts/idempotency.md): Retry sends safely — the same key never sends twice
- [Pagination](https://docs.rray.app/docs/concepts/pagination.md): Cursor-based, both directions, constant cost at any history size