# Albus Documentation

## Docs

- [Get current user information](https://docs.albus.sh/api-reference/auth/get-current-user-information.md): Returns the authenticated user along with every organization they belong to and their roles in each.
- [Health check endpoint](https://docs.albus.sh/api-reference/health/health-check-endpoint.md): Returns 200 OK if the service is healthy
- [Invite a user by email](https://docs.albus.sh/api-reference/invites/invite-a-user-by-email.md): Creates a pending invitation for an email address. Omit organization_id to invite the user as the founder of a new organization that is created on their first sign-in; provide it to invite them into an existing organization. The invitation is redeemed automatically the first time the invitee signs i…
- [Create a secret](https://docs.albus.sh/api-reference/secrets/create-a-secret.md)
- [Delete a secret by name](https://docs.albus.sh/api-reference/secrets/delete-a-secret-by-name.md)
- [Get a secret by name](https://docs.albus.sh/api-reference/secrets/get-a-secret-by-name.md)
- [List all secrets](https://docs.albus.sh/api-reference/secrets/list-all-secrets.md)
- [Update a secret by name](https://docs.albus.sh/api-reference/secrets/update-a-secret-by-name.md)
- [Delete a session](https://docs.albus.sh/api-reference/sessions/delete-a-session.md)
- [Get a session with its messages](https://docs.albus.sh/api-reference/sessions/get-a-session-with-its-messages.md): Returns the session's metadata and a page of its messages ordered by cursor ascending. Use `after` and `limit` to page through messages.
- [List a session's audit log](https://docs.albus.sh/api-reference/sessions/list-a-sessions-audit-log.md): Returns the session's audit log — an immutable, time-ordered record of what happened during its agent runs (LLM calls, tool results, and run outcomes). Events are ordered by the time they occurred. Use `after` and `limit` to page through them; pass the response's `next_cursor` as the next request's…
- [List all sessions](https://docs.albus.sh/api-reference/sessions/list-all-sessions.md)
- [Run or resume a session](https://docs.albus.sh/api-reference/sessions/run-or-resume-a-session.md): Runs the session with the given ID, creating it if it does not exist and resuming it otherwise. Each call is a single invocation, optionally identified by the Idempotency-Key header. Supplying a key makes the call safe to retry: retrying with the same key and an identical body re-attaches to the in-…
- [Create an API token. The token value is returned only in this response.](https://docs.albus.sh/api-reference/tokens/create-an-api-token-the-token-value-is-returned-only-in-this-response.md)
- [Get token metadata by ID. Never returns the token value.](https://docs.albus.sh/api-reference/tokens/get-token-metadata-by-id-never-returns-the-token-value.md)
- [List all API tokens. Never returns token values, only metadata.](https://docs.albus.sh/api-reference/tokens/list-all-api-tokens-never-returns-token-values-only-metadata.md)
- [Revoke an API token by ID](https://docs.albus.sh/api-reference/tokens/revoke-an-api-token-by-id.md)
- [Call the API](https://docs.albus.sh/getting-started/api.md): Authenticate an HTTP request to Albus.
- [Use the Python SDK](https://docs.albus.sh/getting-started/python.md): Install and configure the Albus Python SDK.
- [Use Albus from an agent](https://docs.albus.sh/guides/agents.md): Give coding agents stable, complete instructions for an Albus integration.
- [Documentation release policy](https://docs.albus.sh/guides/releases.md): How the public documentation stays aligned with deployed Albus releases.
- [Albus documentation](https://docs.albus.sh/index.md): Build, run, and integrate AI agents with Albus.
- [API reference](https://docs.albus.sh/reference/overview.md): The authoritative HTTP API contract for the current Albus production release.

## OpenAPI Specs

- [openapi](https://docs.albus.sh/openapi/openapi.yaml)