# Cue API — Full Reference

> Machine-generated from OpenAPI 3.x. Authentication: Bearer token (Supabase JWT).

## GET /health

Health Check

## GET /ready

Readiness Check

## POST /users/subscribe

Subscribe to Newsletter

## POST /users/seed-credits

Seed Welcome Credits

## GET /users/me

Get Current User Profile

## PATCH /users/me

Update Current User Profile

## GET /users/settings/invite-mode

Get invite-only mode status

## GET /users/me/referral

Get Referral Stats

## GET /users/profile/{username}

Get Public Profile

## POST /users/referral/track

Track Referral

## GET /users/referral/validate/{code}

Validate Referral Code

## POST /users/referral/verify

Verify Referral Completion

## POST /users/waitlist

Join Waitlist

## GET /users/waitlist/{share_token}

Check Waitlist Position

## GET /users/leaderboard

Get Referral Leaderboard

## GET /users/leaderboard/me

Get My Leaderboard Rank

## GET /users/public-stats

Public Platform Stats

## POST /users/me/delete

Schedule account deletion

## POST /users/me/cancel-delete

Cancel scheduled account deletion

## GET /users/me/deletion-status

Get account deletion status

## GET /organizations

List Organizations

## POST /organizations

Create Organization

## GET /organizations/{org_id}

Get Organization

## PATCH /organizations/{org_id}

Update Organization

## DELETE /organizations/{org_id}

Delete Organization

## POST /organizations/{org_id}/activate-team

Activate Team Plan

## GET /organizations/{org_id}/members

List Organization Members

## POST /organizations/{org_id}/members

Invite Member

## DELETE /organizations/{org_id}/members/{member_id}

Remove Member

## GET /organizations/{org_id}/invitations

List Pending Invitations

## DELETE /organizations/{org_id}/invitations/{invitation_id}

Revoke Invitation

## GET /folders

List Folders

## POST /folders

Create Folder

## GET /folders/{folder_id}

Get Folder

## PATCH /folders/{folder_id}

Update Folder

## DELETE /folders/{folder_id}

Delete Folder

## POST /folders/{folder_id}/move

Move Folder

## GET /scripts

List Scripts

## POST /scripts

Create Script

## GET /scripts/{script_id}

Get Script

## PATCH /scripts/{script_id}

Update Script

## DELETE /scripts/{script_id}

Delete Script

## GET /scripts/shared/{share_token}

Get Shared Script

## POST /scripts/{script_id}/archive

Archive Script

## POST /scripts/{script_id}/unarchive

Unarchive Script

## POST /scripts/{script_id}/duplicate

Duplicate Script

## POST /scripts/{script_id}/share

Generate Share Link

## DELETE /scripts/{script_id}/share

Revoke Share Link

## POST /activity

Log Activity

## GET /activity/streak

Get Streak Info

## GET /activity/today

Get Today's Activity

## POST /practice-sessions

Start Practice Session

## GET /practice-sessions

List Practice Sessions

## GET /practice-sessions/shared/{share_token}

Get Shared Practice Session

## GET /practice-sessions/{session_id}

Get Practice Session

## PATCH /practice-sessions/{session_id}

Complete Practice Session

## DELETE /practice-sessions/{session_id}

Delete Practice Session

## POST /practice-sessions/{session_id}/share

Generate Session Share Link

## DELETE /practice-sessions/{session_id}/share

Revoke Session Share Link

## GET /recordings/daily-status

Daily Recording Status

## POST /recordings

Register Recording

## GET /recordings

List Recordings

## GET /recordings/{recording_id}

Get Recording

## DELETE /recordings/{recording_id}

Delete Recording

## GET /analytics/summary

Practice Summary

## GET /analytics/weekly-review

Weekly Review

## GET /analytics/script/{script_id}

Script Stats

## GET /analytics/trends

Practice Trends

## GET /analytics/coaching-suggestions

Coaching Suggestions

## GET /practice-goals

Get Practice Goals

## PUT /practice-goals

Set Practice Goals

## GET /organizations/{org_id}/scripts

List Org Scripts

## POST /organizations/{org_id}/scripts

Create Org Script

## PATCH /organizations/{org_id}/scripts/{script_id}

Update Org Script

## DELETE /organizations/{org_id}/scripts/{script_id}

Delete Org Script

## POST /organizations/{org_id}/scripts/{script_id}/template

Toggle Org Template

## GET /organizations/{org_id}/templates

List Org Templates

## GET /organizations/{org_id}/activity

Get Org Activity Feed

## GET /scripts/{script_id}/comments

List Script Comments

## POST /scripts/{script_id}/comments

Add Script Comment

## PATCH /comments/{comment_id}

Update Comment

## DELETE /comments/{comment_id}

Delete Comment

## PATCH /comments/{comment_id}/resolve

Resolve/Unresolve Comment

## GET /recordings/{recording_id}/suggestions

List Recording Suggestions

## POST /recordings/{recording_id}/suggestions

Add Recording Suggestion

## DELETE /suggestions/{suggestion_id}

Delete Suggestion

## GET /push/vapid-key

Get VAPID Public Key

## POST /push/subscribe

Subscribe to Push

## DELETE /push/unsubscribe

Unsubscribe from Push

## POST /invitations/{token}/accept

Accept Invitation

## GET /tags

List Tags

## POST /tags

Create Tag

## PATCH /tags/{tag_id}

Update Tag

## DELETE /tags/{tag_id}

Delete Tag

## POST /tags/{tag_id}/scripts/{script_id}

Add Tag to Script

## DELETE /tags/{tag_id}/scripts/{script_id}

Remove Tag from Script

## GET /tags/script/{script_id}

Get Tags for Script

## POST /credit-rewards/claim

Claim a Credit Reward

## GET /credit-rewards/available

List Available Reward Actions

## GET /credit-rewards/history

Reward History

## GET /credit-rewards/summary

Reward Summary

## GET /credit-rewards/admin/pending

Admin: List Pending Reward Claims

## POST /credit-rewards/admin/{reward_id}/verify

Admin: Verify or Reject Reward Claim

## POST /ai/generate-script

Generate a script with AI

## POST /ai/rewrite-script

Rewrite a script with AI

## POST /ai/convert-to-micro-cues

Convert script to micro cues

## POST /ai/analyze-speech

Analyze a speech recording

## GET /ai/speech-analysis/{recording_id}

Retrieve existing speech analysis

## POST /ai/parse-document

Parse a document to extract text

## POST /ai/transcribe

Transcribe audio to text

## POST /ai/tts

Text to speech

## POST /agent/conversation

Conversational agent with tool calling

## GET /agent/conversations

List user's conversations

## GET /agent/conversations/{conversation_id}

Get conversation with messages

## DELETE /agent/conversations/{conversation_id}

Delete a conversation

## GET /admin/check

Check if current user is admin

## GET /admin/usage/summary

Aggregate usage summary for a period

## GET /admin/usage/daily

Daily usage breakdown

## GET /admin/usage/by-user

Cost breakdown by user

## GET /admin/usage/by-feature

Cost breakdown by feature

## GET /admin/engagement

Platform engagement metrics

## GET /admin/usage/user/{user_id}

Per-feature cost breakdown for a specific user

## GET /admin/waitlist/stats

Get waitlist statistics

## POST /admin/waitlist/batch-invite

Batch invite waitlist users

## GET /admin/settings/invite-mode

Get invite-only mode status (admin)

## PUT /admin/settings/invite-mode

Toggle invite-only mode

## POST /admin/process-deletions

Process scheduled account deletions

## POST /admin/rc-cleanup

Clean up inactive RevenueCat customers

## GET /admin/rc-customers

List RevenueCat customers with subscription status

## POST /admin/rc-delete-customers

Delete selected RevenueCat customers

## POST /admin/push/send

Send a custom push notification

## POST /admin/free-plan-cleanup

Clean up old data for free-plan users