> ## Documentation Index
> Fetch the complete documentation index at: https://docs.holos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Holos API

> Programmatic access to skills, captures, objects, and organizations.

The Holos API is a REST API that gives you programmatic access to all platform resources. It's the same API used by the Holos web dashboard and mobile apps.

## Base URL

```
https://api.holos.io
```

## Authentication

All requests require a bearer token obtained through the magic link flow. Pass the token in the `Authorization` header:

```http theme={null}
Authorization: Bearer <session_token>
```

See [Authentication](/concepts/authentication) for the full token flow.

## Resources

| Resource                                | Description                                         |
| --------------------------------------- | --------------------------------------------------- |
| [Skills](/domains/skills)               | Org-scoped tasks that captures are recorded against |
| [Captures](/domains/captures)           | Recorded spatial sessions                           |
| [Objects](/domains/objects)             | 3D models used in captures and courses              |
| [Organizations](/domains/organizations) | Tenant accounts and member management               |
| [Users](/domains/users)                 | User identity and member profiles                   |

## Endpoint reference

The full endpoint-by-endpoint reference and interactive playground are currently **internal-only** — they aren't published here yet. Holos engineers can preview them locally; see [the holos-docs README](https://github.com/holosinc/holos-docs#internal-api-reference). The OpenAPI 3.1 spec is generated from and maintained in the `holos-api` repository.

The pages below cover the concepts you need to integrate: authentication, webhooks, error shapes, and the per-resource guides.

## Concepts

<CardGroup cols={3}>
  <Card title="Authentication" icon="https://mintcdn.com/holosinc/3qjjKOLHhziCZQk_/images/icons/anchor.svg?fit=max&auto=format&n=3qjjKOLHhziCZQk_&q=85&s=17f5ea99b96c4f1d670d7b2c0f45f93f" href="/concepts/authentication" width="100" height="100" data-path="images/icons/anchor.svg">
    Session tokens and the bearer flow
  </Card>

  <Card title="Webhooks" icon="https://mintcdn.com/holosinc/3qjjKOLHhziCZQk_/images/icons/paths.svg?fit=max&auto=format&n=3qjjKOLHhziCZQk_&q=85&s=00317d8121d44528a8cae26f66a9d8d3" href="/concepts/webhooks" width="100" height="100" data-path="images/icons/paths.svg">
    Event notifications via Stytch and Svix
  </Card>

  <Card title="Errors" icon="https://mintcdn.com/holosinc/3qjjKOLHhziCZQk_/images/icons/flag.svg?fit=max&auto=format&n=3qjjKOLHhziCZQk_&q=85&s=07cd87f9615b046049e9e045e05812b5" href="/concepts/errors" width="100" height="100" data-path="images/icons/flag.svg">
    Error format and status codes
  </Card>
</CardGroup>