API Reference

Complete reference for the AISquare Studio API
View as Markdown

The AISquare Studio API provides programmatic access to the full AISquare platform — AI Studios, experiences, collections, community, analytics, and more.


Base URL

All API endpoints are available under:

https://api.aisquare.com/api/v1/

Authentication

AISquare supports two authentication methods:

MethodHeader / LocationDescription
API KeyX-API-KEY headerServer-to-server and partner integrations
Cookie JWTaccess cookieBrowser-based sessions

For most integrations, use the API key:

X-API-KEY: <your_api_key>

See Authentication for detailed setup instructions.


API groups

The API is organized into the following groups:

GroupDescription
AI StudiosPublication data, experiences, creators, metrics, permissions
ActivityUser activity tracking and history
BookingsCal.com scheduling integration
CollectionsCreate and manage curated experience groups
CommunityContributors, events, and public discovery
Content VaultRAG document management and Google Drive integration
EnterprisesEnterprise domain management and OIDC SSO
ExperiencesCreate, manage, publish, and generate AI experiences
GTM StudioGo-to-market discovery, outreach, and video generation
IAMUser accounts, profiles, authentication, social login
InvitesWorkspace invitation management
MembershipsWorkspace membership management
MetricsResource engagement metrics and user interaction tracking
NotificationsUser notification management
PaymentsSubscription plans and Stripe integration
PlatformsPlatform configuration and redirects
PlayerGamification: ELO, leaderboards, game stats
PodcastsPodcast creation, generation, and management
ProblemsQuest-based challenges and problem generation
PublicationsPublication CRUD, blogs, collaborators, settings

Common patterns

Pagination

Most list endpoints support pagination:

ParameterDescription
pagePage number
page_sizeResults per page

Paginated responses include:

1{
2 "count": 100,
3 "next": "https://api.aisquare.com/api/v1/.../&page=2",
4 "previous": null,
5 "results": []
6}

Filtering and sorting

Many endpoints support query parameters for filtering and sorting:

ParameterDescription
searchFree text search
orderingSort field (trending, newest, popular)
typeResource type filter (AI_EXPERT, AI_NOTE, QUEST)

Publication scoping

Most AI Studio endpoints require a publication URL in the request body:

1{
2 "url": "your-studio-url"
3}

Status codes

StatusMeaning
200Success
201Resource created
204Resource deleted
400Invalid request or missing parameters
401Authentication required
403Access forbidden
404Not found or access denied
500Internal server error

See Errors for detailed error handling guidance.