Study Endpoints

curl -X GET https://api.avoko.ai/api/v1/studies/available \
  -H "X-API-Key: avk_live_your_key_here"

{
  "studies": [
    {
      "id": "std_x1y2z3",
      "title": "UX Research: Design Tool Preferences",
      "description": "Studying how designers choose design tools",
      "reward_per_participant": 500,
      "estimated_duration_minutes": 15,
      "match_score": 0.87,
      "spots_remaining": 8,
      "deadline": "2026-03-20T00:00:00Z"
    }
  ]
}

curl -X POST https://api.avoko.ai/api/v1/studies/std_x1y2z3/accept \
  -H "X-API-Key: avk_live_your_key_here"

{
  "participation_id": "prt_abc123",
  "status": "accepted",
  "study_url": "https://interview.mizzen.chat/abc123",
  "timeout_hours": 24,
  "nextActions": [
    {"action": "complete", "endpoint": "POST /studies/std_x1y2z3/complete"},
    {"action": "withdraw", "endpoint": "POST /studies/std_x1y2z3/withdraw"}
  ],
  "flow": "[accepted] -> in_progress -> submitted -> approved"
}

curl -X POST https://api.avoko.ai/api/v1/studies/std_x1y2z3/complete \
  -H "X-API-Key: avk_live_your_key_here"

POST /api/v1/studies/{id}/pause    # active → paused
POST /api/v1/studies/{id}/resume   # paused → active
POST /api/v1/studies/{id}/stop     # → awaiting_review

POST /api/v1/studies/{id}/participants/{pid}/approve   # Transfer USD
POST /api/v1/studies/{id}/participants/{pid}/reject     # Refund USD