GraphQL API Reference
The Objectuve GraphQL API is served from a single endpoint: POST /graphql.
All queries, mutations, and batch operations go through this endpoint. Authentication uses the Clerk RS256 JWT passed in the SessionToken header.
Note: The header is
SessionToken(PascalCase). It is notAuthorization: Bearer. See Authentication for the full Clerk flow.
For an interactive explorer, visit api-docs.objectuve.com (GraphQL Voyager schema explorer).
Contents
| Page | Description | Count |
|---|---|---|
| Queries | Root query fields — read data | 111 fields |
| Mutations | Root mutation fields — write/change data | 167 fields |
| Types | Object types returned by queries and mutations | 356 types |
| Enums | Enumeration values | 7 enums |
| Inputs | Input object types for mutation arguments | 7 inputs |
| Scalars | Custom scalar types | 4 scalars |
Queries by category
Admin: adminActions, adminAiUsage, adminSearchUsers, adminStats, adminTeamsMonitoring
Ai: aiEmployee, aiEmployees, aiRequest, aiRun
Ally: allyActivityFeed, allyInvitePreview
Badge: badgeHolderCount, badgeStats
Coach: coachConversation, coachModelSetting
Community: community, communityBadges, communityChallenge, communityChallengeLeaderboard, communityChallenges, communityFeed, communityGoals, communityInsights, communityMemberCheck, communityMembers, communitySuggestions
Content: contentReports
Demo: demoDataRunStatus, demoScopePreview
Enneagram: enneagramAssessment, enneagramAssessmentHistory
Feedback: feedbackPost, feedbackPosts, feedbackStats, feedbackTags, feedbackWeeklySummary
Goal: goal, goalCategories, goalEvent, goalKinds, goalProgressData, goalSummary, goalTemplates, goals
Notification: notificationHistory
Other: accountabilityPartner, activeSeasonalEvent, activeSeasonalEvents, askDocsQuestion, askGuideQuestion, authzCheck, blockedUsers, communities, connectedApps, criticalPathReminderPreferences, criticalPathStimXpStatus, criticalPathToday, curatableCommunities, dataImportStatus, editorialCommunities, findUserForInvite, formingCommunities, funnelStats, gdprRequest, gdprRequests, isFollowingGoal, me, moderationQueue, myAllyInvites, myLatestDataExport, myTeam, myTeams, outgoingAllyRequests, pendingAllyRequests, pendingArtifacts, pendingCounts, personalAnalyticsActivityHeatmap, personalAnalyticsCompletionByCategory, personalAnalyticsMonthInReview, personalAnalyticsStreakHistory, personalAnalyticsXpOverTime, pickableFeedbackTags, publicFeedbackPost, publicFeedbackPosts, publicGoal, recentArtifacts, recommendedCommunities, searchUsers, seasonalEvent, seasonalEvents, shareableMoment, suggestedAllies, systemHealth, tourFunnelStats, trendingCommunities, unifiedFeed, weeklyDigestPreferences, wordCloud
Plan: plans
Team: teamHome, teamInvitePreview, teamLeaderboard, teamLeaderboardOptOutStats, teamMemberActivity, teamNotificationPreferences, teamPulseEligibility, teamSettings
User: user, userAllies, userByUsername, users
Mutations by category
Other: acceptAllyInvite, acceptAllyRequest, acceptHabitIntegrationMapping, acceptPaceSuggestion, acceptPartnerRequest, acceptStreakMercy, acceptTeamInvite, acknowledgeAction, acknowledgeAllNotifications, acknowledgeCollectiveGoalPrivacyContract, acknowledgeNotification, addCommunitySuggestion, addGoal, addGoalEvent, addGoalEventComment, addGoalToCommunity, addMoodLog, addPostComment, adjustTeamSeats, approveAiArtifact, archiveFeedbackTag, archiveSubCommunity, beginDataImport, blockAlly, bulkReviewContentFlags, cancelSupporterSubscription, cancelTeamSubscription, checkInHabit, checkValidUsername, claimAiArtifact, claimStreakInsurance, commitDataImport, completeOnboardingAndCreateGoal, connectChessCom, connectStrava, createAllyInvite, createCheckoutSession, createCollectiveGoal, createCommunity, createCommunityChallenge, createCommunityPost, createFeedbackComment, createFeedbackPost, createFeedbackTag, createSeasonalEvent, createSubCommunity, createTeamInvite, declineAllyRequest, declinePartnerRequest, deleteDemoEntity, deleteNotification, deleteOwnAccount, disconnectIntegrationConnection, dismissDashboardHint, dismissEnneagramCard, dismissHabitIntegrationMapping, editHabitIntegrationMapping, endPartnership, enqueueClear, enqueueReseed, enqueueScopeReset, ensureTodaysCoachMessage, executeGdprDeletion, executeGdprExport, followCommunity, generateGoalDraft, generateMilestones, getAdvice, getBillingPortalUrl, getInsight, grantAchievementDebug, inviteAllyToCommunity, joinCommunity, joinCommunityChallenge, joinSeasonalEvent, joinSubCommunity, leaveCommunity, leaveCommunityChallenge, leaveSeasonalEvent, leaveSubCommunity, mintCheckInToken, optIntoCollectiveGoal, optOutOfCollectiveGoal, pauseAiEmployee, pauseIntegrationConnection, promoteTeamMember, recordCriticalPathPlay, recordShare, recordUserAction, refineDescription, refineGoal, rejectAiArtifact, removeAlly, removeTeamMember, reorderMilestones, repairStreak, reportContent, requestDataExport, requestMagicCode, rerunHabitIntegrationMapping, resetOnboarding, resumeIntegrationConnection, revertLastGoalEvent, reviewContentFlag, reviewContentReport, revokeAllyInvite, revokeCheckInToken, revokeTeamInvite, seedIntegrationActivityDebug, sendAllyRequest, sendEncouragement, sendPartnerNudge, sendPartnerRequest, setColorTheme, setCommunityEditorialSlot, setCommunityFeatured, setCriticalPathActiveTheme, setCriticalPathReminderPreferences, setDefaultSubCommunity, setGoalPartnerSharing, setGoalVisibility, setLeaderboardVisibility, setSeasonalEventActive, setTeamNotificationPreferences, setWeeklyDigestPreferences, startTeamBillingPortal, startTeamCheckout, storeDeviceToken, storeFeatureTourState, storeOnboardingState, storeUserDetails, submitEnneagramAssessment, submitTeamPulse, suggestGoals, syncUser, toggleFeedbackVote, toggleFollowGoal, toggleGoalEventEncouragement, toggleGoalEventReaction, transferTeamBillingOwnership, triggerAiRun, unarchiveSubCommunity, unblockUser, unfollowCommunity, updateAiEmployee, updateCoachModel, updateCoachWarmupContext, updateCoachingPreferences, updateDashboardPreferences, updateDemoCommunity, updateDemoGoal, updateDemoUser, updateFeedbackPostStatus, updateFeedbackPostTags, updateFeedbackTag, updateGoal, updateGoalEvent, updateGoalMotivationSnapshot, updatePrivacySettings, updateSeasonalEvent, updateShowcasedAchievements, updateSubCommunity, updateUser, updateUserPhoto, updateUserRoles, useStreakFreeze, verifyMagicCode
ID convention
All IDs exposed by this API are publicId values — URL-safe base64 tokens generated on record creation. Internal integer IDs are never returned. Pass publicId values wherever a mutation or query requires an id argument.
Batch requests
Send an array of operation objects to /graphql:
[
{ "query": "query { goalCategories { id name } }" },
{ "query": "query { goalKinds { id name } }" }
]Last updated: 2026-09-19 (auto-generated from schema.graphql)