Extrachill Api
Central REST API infrastructure for the Extra Chill network. Enables headless use of the platform.
Changelog
This file records notable changes in the ExtraChill API plugin. [0.11.2] - 2026-03-05 Changed Wrap QR route around extrachill/generate-qr-code ability...
Activity Feed
Retrieve paginated activity feed with configurable filtering and visibility controls. Endpoint Get Activity Feed Endpoint: GET /wp-json/extrachill/v1/activity Purpose: Query activity...
Object Resolver
Resolve and retrieve data for different object types (posts, comments, artists) with context-aware permission checks. Endpoint Get Object Endpoint: GET...
Artist Access Management API
Handles artist platform access approval and rejection requests. Endpoints List Pending Requests Endpoint: GET /wp-json/extrachill/v1/admin/artist-access Purpose: Retrieve all pending artist...
Lifetime Extra Chill Membership Management
Manage Lifetime Extra Chill Memberships for users. Grant or revoke membership status via REST API with admin-only access. Primary benefit...
Taxonomy Sync Endpoint
Sync shared taxonomies from the main site to selected target sites. Designed for Admin Tools UI usage. Endpoint POST /wp-json/extrachill/v1/admin/taxonomies/sync...
Team Member Management
Manage team member status synchronization across the multisite network. Control automatic sync and manual overrides for team member assignment. Endpoints...
Click Analytics Endpoint
Route POST /wp-json/extrachill/v1/analytics/click Purpose Unified click tracking endpoint that routes to appropriate storage based on click type. Consolidates share tracking...
Analytics Events Endpoints
Routes GET /wp-json/extrachill/v1/analytics/events GET /wp-json/extrachill/v1/analytics/events/summary GET /wp-json/extrachill/v1/analytics/meta Purpose These endpoints expose network-wide analytics events stored in the Extra Chill Analytics...
Link Page Analytics Endpoint
Route GET /wp-json/extrachill/v1/analytics/link-page Purpose Returns aggregated performance metrics for a single artist link page so roster members can review traffic...
Analytics Meta Endpoint
Route GET /wp-json/extrachill/v1/analytics/meta Purpose Returns metadata used to build analytics filters in admin/reporting UIs. Permissions Requires the current user to...
Async View Count Endpoint
Route POST /wp-json/extrachill/v1/analytics/view Purpose Captures post view events asynchronously. Useful for blocks and templates that want lightweight analytics without blocking...
Artist Analytics Endpoint
Route GET /wp-json/extrachill/v1/artists/{id}/analytics Purpose Retrieve link page performance analytics for an artist, including total views, clicks, and click data for...
Artist Core Data Endpoint
Route GET/PUT /wp-json/extrachill/v1/artists/{id} Purpose Retrieve and update core artist profile data including name, bio, profile images, and link page reference....
Artist Link Page Data Endpoint
Route GET/PUT /wp-json/extrachill/v1/artists/{id}/links Purpose Retrieve and update link page presentation data for an artist. This includes button links organized in...
Artist Permissions Endpoint
Route GET /wp-json/extrachill/v1/artists/{id}/permissions Purpose Tells extrachill.link whether the logged-in user can edit a specific artist profile, powering the client-side "Edit"...
Artist Roster Management
REST API endpoints for managing artist roster members and pending invitations. Endpoints List Roster Members and Invites Endpoint: GET /wp-json/extrachill/v1/artists/{id}/roster...
Artist Subscriber Signup Endpoint
Route POST /wp-json/extrachill/v1/artists/{id}/subscribe Purpose Used by public link pages so fans can subscribe to artist updates. The endpoint validates inputs...
Browser Handoff Endpoint
Returns a one-time URL that sets WordPress auth cookies in a real browser and redirects to the requested destination. Used...
Google OAuth Authentication
Authenticate users with Google OAuth using ID tokens and return access + refresh tokens for API access. Endpoints Google OAuth...
Auth Login
Authenticate a user and return access + refresh tokens for API access. Supports device tracking for session management and optional...
Auth Logout
Revoke user session tokens and end authentication for a specific device. Endpoints User Logout Endpoint: POST /wp-json/extrachill/v1/auth/logout Purpose: Revoke refresh...
Auth Me
Retrieve current authenticated user data including onboarding completion. Endpoints Get Current User Endpoint: GET /wp-json/extrachill/v1/auth/me Purpose: Return the currently authenticated...
Auth Register
Create a new user account with token-based authentication. Supports artist profile creation, professional status, and invitation-based registration. Endpoints User Registration...
Band Name Generator Endpoint
Route POST /wp-json/extrachill/v1/blog/band-name Purpose Generate band name suggestions using AI. This endpoint powers the ExtraChill Blog "Band Name Generator" block,...
Image Voting Vote Endpoint
Route POST /wp-json/extrachill/v1/image-voting/vote Purpose Cast a vote in an image voting block instance. This endpoint allows visitors to vote on...
Image Voting Vote Count Endpoint
Route GET /wp-json/extrachill/v1/blog/image-voting/vote-count/{post_id}/{instance_id} Purpose Returns the latest vote tally for a specific Image Voting block instance embedded in a post....
Rapper Name Generator Endpoint
Route POST /wp-json/extrachill/v1/blog/rapper-name Purpose Generate rapper name suggestions using AI. This endpoint powers the ExtraChill Blog "Rapper Name Generator" block,...
Blog Taxonomy Counts Endpoint
Route GET /wp-json/extrachill/v1/blog/taxonomy-counts Purpose Returns taxonomy term counts and archive URLs from the main blog site (Blog ID resolved via...
AI Adventure Endpoint
Route POST /wp-json/extrachill/v1/blog/ai-adventure Purpose Powers the ExtraChill Blog "AI Adventure" block by proxying structured story prompts to the AI provider...
Chat Message Endpoint
Route POST /wp-json/extrachill/v1/chat/message Purpose Sends a user’s message to the ExtraChill AI assistant, saves the updated conversation, and returns both...
Chat History Reset Endpoint
Route DELETE /wp-json/extrachill/v1/chat/history Purpose Clears the authenticated user’s saved AI chat transcript so future prompts start fresh within the extrachill-chat...
Community Drafts
Manage bbPress topic and reply drafts with context-aware storage and retrieval. Endpoints Get Draft Endpoint: GET /wp-json/extrachill/v1/community/drafts Purpose: Retrieve a...
Community Upvote Endpoint
Route POST /wp-json/extrachill/v1/community/upvote Purpose Records an upvote (or removes it, depending on the helper implementation) for forum topics and replies...
OAuth Configuration
REST API endpoint for retrieving OAuth provider configuration for client applications. Endpoint Get OAuth Configuration Endpoint: GET /wp-json/extrachill/v1/config/oauth Purpose: Return...
Contact Form Submission
REST API endpoint for handling contact form submissions with security verification and email integration. Endpoint Submit Contact Form Endpoint: POST...
Documentation Info
Provide endpoint documentation and feature metadata for documentation agents and API consumers. Self-documenting endpoint that surfaces critical platform information. Endpoints...
Documentation Sync
REST API endpoint for synchronizing documentation content from source .md files to the documentation platform. Endpoint Sync Documentation Endpoint: POST...
Event Submission Flow Endpoint
Route POST /wp-json/extrachill/v1/event-submissions Purpose Accepts public event submissions from blocks and forms, verifies Cloudflare Turnstile tokens, uploads optional flyers, and...
Upcoming Event Counts Endpoint
Route GET /wp-json/extrachill/v1/events/upcoming-counts Purpose Returns counts of upcoming events (events with _datamachine_event_datetime >= today) for taxonomy terms on the events...
Unified Media Upload Endpoint
Route POST/DELETE /wp-json/extrachill/v1/media Purpose Centralized image upload and management for all platform contexts. Handles upload, assignment, old image cleanup, and...
Newsletter Campaign Push
Push newsletter posts to Sendy email service for campaign distribution. Endpoint Push Campaign to Sendy Endpoint: POST /wp-json/extrachill/v1/newsletter/campaign/push Purpose: Prepare...
Newsletter Subscription Endpoint
Route POST /wp-json/extrachill/v1/newsletter/subscribe Purpose Centralizes opt-ins from every signup surface (site header, article footers, blocks) and forwards them to the...
SEO Audit Endpoint
Starts a new SEO audit across the multisite network. Endpoint POST /wp-json/extrachill/v1/seo/audit Authentication Requires manage_network_options capability (Super Admin only). Request...
SEO Audit Continue Endpoint
Continues a batch audit from where it left off. Endpoint POST /wp-json/extrachill/v1/seo/audit/continue Authentication Requires manage_network_options capability (Super Admin only). Request...
SEO Audit Status Endpoint
Returns current audit results and progress. Endpoint GET /wp-json/extrachill/v1/seo/audit/status Authentication Requires manage_network_options capability (Super Admin only). Request Parameters None. Response...
Shop Orders
Manage artist shop orders, track fulfillment, and issue refunds for sold products. Endpoints List Artist Orders Endpoint: GET /wp-json/extrachill/v1/shop/orders Purpose:...
Shop Product Images
Manage product images with support for featured image and gallery uploads. Supports up to 5 images per product. Endpoints Upload...
Shop Products Endpoint
Routes GET /wp-json/extrachill/v1/shop/products POST /wp-json/extrachill/v1/shop/products GET /wp-json/extrachill/v1/shop/products/{id} PUT /wp-json/extrachill/v1/shop/products/{id} DELETE /wp-json/extrachill/v1/shop/products/{id} Purpose WooCommerce product CRUD for artists. Products are stored...
Shipping Address Endpoints
Manage artist shipping from-address for order fulfillment. GET /wp-json/extrachill/v1/shop/shipping-address Get artist's configured shipping address. Parameters Parameter Type Required Description artist_id...
Shipping Labels Endpoints
Purchase and retrieve shipping labels via Shippo integration. GET /wp-json/extrachill/v1/shop/shipping-labels/{order_id} Get existing shipping label for an order. Parameters Parameter Type...
Stripe Connect
Stripe Connect is scoped to an artist_profile post (artist site). These endpoints support checking account status and generating onboarding/dashboard links....
Stream Status
Check the current status of streaming functionality. Provides information about stream availability, configuration, and operational state. Endpoints Get Stream Status...
QR Code Generator
REST API endpoint for generating high-resolution print-ready QR codes for any URL. Endpoint Generate QR Code Endpoint: POST /wp-json/extrachill/v1/tools/qr-code Purpose:...
User Artist Relationships
Manage the relationship between users and artist profiles they manage. Control which artists are associated with each user account. Endpoints...
User Leaderboard Endpoint
Endpoint: GET /wp-json/extrachill/v1/users/leaderboard Purpose: Retrieve paginated leaderboard of top users ranked by total points with badges and rank information. Parameters...
User Onboarding
Manage the user onboarding flow for new account setup, profile completion, and artist status configuration. Endpoints Get Onboarding Status Endpoint:...
User Search
Search for users by username, email, or display name with context-aware responses. Supports both public @mentions and admin-only full data...
User Profile
Retrieve detailed user profile information including account status, permissions, and artist management capabilities. Endpoints Get User Profile Endpoint: GET /wp-json/extrachill/v1/users/{id}...
Avatar Menu
This endpoint has been removed. Mobile and other clients should use GET /wp-json/extrachill/v1/auth/me and build navigation client-side from the returned...
Wire Taxonomy Counts Endpoint
Route GET /wp-json/extrachill/v1/wire/taxonomy-counts Purpose Returns post counts and term archive URLs for taxonomy terms on the wire site (Blog ID...
Cross-Domain Cookie Controls
Purpose Adds SameSite=None; Secure to every WordPress authentication cookie so REST requests originating from extrachill.link carry logged-in identity when hitting...
ExtraChill API Plugin Core
Singleton Bootstrap ExtraChill_API_Plugin::get_instance() loads the plugin once and keeps all REST routes centralized. Constructor loads every PHP file within inc/routes/...