# References

URL: https://pieowl.com/docs/api/manage/references



Authentication [#authentication]

Requires a `root` client. See the [Authentication](/docs/api/authentication) guide.

Base URL [#base-url]

```
https://api.pieowl.com/manage/references
```

What are references? [#what-are-references]

References are markers on your charts. Use them for product launches, campaign starts, feature releases, or any date you want to compare against changes in your numbers.

Endpoints [#endpoints]

| Method   | Path                      | What it does                                               |
| -------- | ------------------------- | ---------------------------------------------------------- |
| `GET`    | `/manage/references`      | Lists all references. Add `projectId` (site ID) to filter. |
| `GET`    | `/manage/references/{id}` | Gets one reference                                         |
| `POST`   | `/manage/references`      | Creates a reference                                        |
| `PATCH`  | `/manage/references/{id}` | Updates a reference                                        |
| `DELETE` | `/manage/references/{id}` | Deletes a reference                                        |

Create a reference [#create-a-reference]

```bash
curl -X POST 'https://api.pieowl.com/manage/references' \
  -H 'Content-Type: application/json' \
  -H 'pieowl-client-id: YOUR_ROOT_CLIENT_ID' \
  -H 'pieowl-client-secret: YOUR_ROOT_CLIENT_SECRET' \
  -d '{
    "projectId": "YOUR_PROJECT_ID",
    "title": "New pricing page",
    "description": "Launched the new pricing page",
    "datetime": "2026-09-15T09:00:00Z"
  }'
```

For full request and response schemas, see the [API Reference](/docs/api-reference).