curl -X POST https://developer.thehog.ai/api/deep-research \
  -H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
  -H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: example-idempotency-key" \
  -d '{
    "prompt": "What are the top strategic priorities for Acme Corp this quarter?",
    "schema": { "type": "object", "properties": { "priorities": { "type": "array", "items": { "type": "string" } } } }
  }'

// Returned whether this is the first call or a retry — identical either way
{
  "operationId": "op_01HZ9K2QW3RV4M5N6P7Q8R9S0T",
  "status": "queued",
  "pollUrl": "https://developer.thehog.ai/api/operations/op_01HZ9K2QW3RV4M5N6P7Q8R9S0T",
  "meta": {
    "requestId": "3f7a1c2e-88b4-4d0e-a1f5-0c9e2b3d7f4a"
  }
}

import { randomUUID } from 'crypto';

// Generate once per logical job, before the first attempt
const idempotencyKey = randomUUID();

// Use the same key for all retries of this specific job
const response = await fetch('https://developer.thehog.ai/api/deep-research', {
  method: 'POST',
  headers: {
    'X-Access-Key': process.env.THEHOG_ACCESS_KEY,
    'X-Secret-Key': process.env.THEHOG_SECRET_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': idempotencyKey,
  },
  body: JSON.stringify({ prompt: '...', schema: { /* ... */ } }),
});