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

# Quickstart

> Authenticate and make your first request

## Prerequisites

Before you begin, you must have:

* A Primula username and password
* The hostname of your API deployment (examples below use `api.example.com`)

## Get started

<Steps>
  <Step title="Create a session">
    Exchange your credentials for an access token.

    ```bash theme={null}
    curl -X POST https://api.example.com/primula/api/v3/sessions \
      -H "Content-Type: application/json" \
      -d '{"username": "example.user", "password": "<your-password>"}'
    ```

    The response returns HTTP `201` with your tokens:

    ```json theme={null}
    {
      "access_token": "<access-token>",
      "refresh_token": "<refresh-token>"
    }
    ```
  </Step>

  <Step title="Call a protected endpoint">
    Send the access token in the `Authorization` header.

    ```bash theme={null}
    curl https://api.example.com/primula/api/v3/schools \
      -H "Authorization: Bearer <access-token>"
    ```
  </Step>

  <Step title="Explore the API">
    Every endpoint is documented in the [API reference](/api-reference/introduction), where you can also try requests from your browser.
  </Step>
</Steps>

<Note>
  V3 has no refresh or logout endpoint. When your token stops working, create a new session.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.