References | Pieowl

Authentication

Requires a root client. See the Authentication guide.

Base URL

plaintext

https://api.pieowl.com/manage/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

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

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.