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

# Quickstart

> Provision a workspace in three calls.

This walkthrough adds a monitor and publishes a status page using your API token.
First, set it as an environment variable:

```bash theme={null}
export SENTIVEL_TOKEN="sv_..."
```

<Steps>
  <Step title="Confirm the token works">
    ```bash theme={null}
    curl https://www.sentivel.com/api/v1/me \
      -H "Authorization: Bearer $SENTIVEL_TOKEN"
    ```

    You get back the workspace, the token's role, and its capabilities.
  </Step>

  <Step title="Add a monitor">
    Creating a monitor also creates its public component. The first check runs on
    the next poll cycle (within about two minutes).

    ```bash theme={null}
    curl -X POST https://www.sentivel.com/api/v1/monitors \
      -H "Authorization: Bearer $SENTIVEL_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{ "name": "API", "target": "https://api.acme.com/health", "expectedStatusCodes": [200] }'
    ```

    <Note>
      The target is fetched server-side on every poll, so private, loopback, and
      internal addresses are rejected. Public http(s) only.
    </Note>
  </Step>

  <Step title="Publish a status page">
    ```bash theme={null}
    curl -X POST https://www.sentivel.com/api/v1/status-pages \
      -H "Authorization: Bearer $SENTIVEL_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{ "name": "Acme Status", "vanityUrl": "acme" }'
    ```

    Your page is live at `https://acme.sentivel.com`.
  </Step>
</Steps>

## Next steps

Browse the full [API reference](/me) for every endpoint, field, and response,
generated from the live OpenAPI spec at
[`/api/v1/openapi.json`](https://www.sentivel.com/api/v1/openapi.json).