> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/platform/api-reference/authentication.md).

# Authentication

Some endpoints require authentication in order to be used, you'll need to pass your API key in the `Authorization` header, you can find your API key in your [User Account page](https://statuspal.io/admin/profile) or under your organization's "Security > API" Keys page.

**Example authenticated request:**

```bash
curl -X POST \
  https://statuspal.io/api/v2/status_pages/:subdomain/incidents \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <your-api-key>' \
  -d '{
   "incident": {
      "type": "major",
      "title": "DB connection issues",
      "service_ids": [1],
      "updates": [{ "type": "issue", "description": "We are investigating" }]
    }
  }'
```
