API Reference

Build custom integrations with the Anomalia REST API. All endpoints require authentication and return JSON.

Base URL

https://anomalia.so/api/v1

Authentication

Every request needs a Bearer token in the Authorization header.

Supabase JWT (CLI / Web session)

Obtained via the CLI login flow. Auto-refreshes. Expires after ~1 hour.

Authorization: Bearer <jwt_token>

API Key (integrations)

Long-lived key generated from the dashboard. Full read & write access. Starts with anomalia_.

Authorization: Bearer anomalia_live_...

Error Handling

All errors return a consistent JSON body:

{ "error": "Human-readable message" }

Code	Meaning
`401`	Unauthorized — missing or invalid token
`403`	Forbidden — API key has no access to this brand
`404`	Not found
`405`	Method not allowed
`500`	Internal server error

Quick Start

export TOKEN="anomalia_live_..."

# List brands
curl -H "Authorization: Bearer $TOKEN" https://anomalia.so/api/v1/brands

# Get posts
curl -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts

# Approve a post
curl -X POST -H "Authorization: Bearer $TOKEN" \
  https://anomalia.so/api/v1/brands/my-brand/posts/ID/approve