Cookies API

Manage the cookies discovered on your site by cookie scanning.

GET /api/v1/sites/:siteId/cookies List all cookies

Returns all cookies discovered on the site. Cookies with is_new: 1 were detected in the most recent scan and haven’t been reviewed yet.

Response

{
"cookies": [
  {
    "id": "01HXYZ...",
    "site_id": "01HABC...",
    "name": "_ga",
    "domain": ".google-analytics.com",
    "category": "analytics",
    "purpose": "Google Analytics tracking cookie",
    "expiry_days": 730,
    "first_seen_at": "2026-01-15T10:00:00Z",
    "last_seen_at": "2026-02-14T02:00:00Z",
    "is_new": 0
  },
  {
    "id": "01HDEF...",
    "name": "_fbp",
    "domain": ".facebook.com",
    "category": "marketing",
    "purpose": "Meta Pixel browser identification",
    "expiry_days": 90,
    "first_seen_at": "2026-02-14T02:00:00Z",
    "last_seen_at": "2026-02-14T02:00:00Z",
    "is_new": 1
  }
]
}

PUT /api/v1/sites/:siteId/cookies/:cookieId Update cookie category

Updates a cookie’s category classification. Valid categories: necessary, analytics, marketing, functional, unclassified. Changing a cookie’s category marks the config as unpublished — you’ll need to publish for the change to take effect in the consent banner.

Request Body

{
"category": "marketing"
}

Response

{
"success": true
}