Endpoints

bash
c2 endpoints                    # List all endpoints
c2 endpoints --groups           # Grouped by namespace
c2 describe rightsholder.list   # Detailed endpoint info

typescript
import { createClient } from '@chapter-two-music/sdk';

const client = createClient({
  apiUrl: 'https://api.prod.chaptertwo.com',
  token: process.env.C2_TOKEN!,
  orgId: 'your-org-uuid',
});

// Query (GET)
const data = await client.query('rightsholder.list', {
  pagination: { page: 1, limit: 10 },
});

// Mutation (POST)
const result = await client.mutate('rightsholder.create', {
  name: 'New Artist',
});

bash
# Query (GET) — input is URL-encoded in the query string
curl -H "Authorization: Bearer $TOKEN" \
     "https://api.prod.chaptertwo.com/trpc/rightsholder.list?batch=1&input=%7B%220%22%3A%7B%22organizationId%22%3A%22YOUR_ORG_ID%22%7D%7D"

# Mutation (POST) — input is in the JSON body
curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"0":{"organizationId":"YOUR_ORG_ID","name":"New Artist"}}' \
     "https://api.prod.chaptertwo.com/trpc/rightsholder.create?batch=1"

# Response format (array, indexed to match batch)
# [{"result":{"data":{"id":"...","name":"New Artist",...}}}]

typescript
{
  query: {
    measures?: string[];        // e.g. ["EarningsView.totalEarnings"]
    dimensions?: string[];      // e.g. ["EarningsView.source"]
    filters?: Array<{
      member: string;           // e.g. "EarningsView.source"
      operator: string;         // e.g. "equals", "notEquals", "contains", "gt", "lt"
      values?: string[];        // e.g. ["Spotify"]
    }>;
    timeDimensions?: Array<{
      dimension: string;        // e.g. "EarningsView.statementPeriod"
      granularity?: string;     // "day" | "week" | "month" | "quarter" | "year"
      dateRange?: string | [string, string]; // e.g. "Last 12 months" or ["2024-01-01", "2024-12-31"]
    }>;
    order?: Record<string, "asc" | "desc">;  // e.g. {"EarningsView.totalEarnings": "desc"}
    limit?: number;             // 1-5000
    total?: boolean;            // include total count (default: false)
  }
}

bash
curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"0":{"organizationId":"YOUR_ORG_ID","query":{"measures":["EarningsView.totalEarnings"],"dimensions":["EarningsView.trackTitle"],"order":{"EarningsView.totalEarnings":"desc"},"limit":10}}}' \
     "https://api.prod.chaptertwo.com/trpc/cube.query?batch=1"