API and OpenAPI Documentation

Mind Your Now provides a comprehensive REST API with full OpenAPI specification. You can explore all endpoints through our interactive Swagger UI documentation or integrate directly using the JSON schema.

API Base URL

Production API: https://api.mindyournow.com

Interactive Documentation

🔗 Explore Mind Your Now API →

Our Swagger UI provides:

• Interactive Testing: Test API endpoints directly from the browser
• Request/Response Examples: See real data formats and expected parameters
• Authentication Flows: Understand how to authenticate your requests
• Complete Schema: Download OpenAPI JSON at https://api.mindyournow.com/v3/api-docs

Authentication

Mind Your Now supports two authentication methods:

JWT Authentication (Web & Mobile Apps)

The React web app and mobile app use JWT tokens issued via Auth0. These are automatically handled by the frontend — no setup needed for end users.

API Key Authentication (Integrations & Plugins)

For programmatic access, AI assistants, and third-party integrations, use API keys:

• Header: X-API-KEY: <your_api_key>
• Generate and manage keys from Settings → API Keys in the web app

curl -H "X-API-KEY: YOUR_API_KEY" \
  "https://api.mindyournow.com/api/v2/unified-tasks"

API Key Scopes

Each API key is issued with one or more scopes that control which endpoints it can access.

Full Access Scope

Scope	Description
AGENT_FULL	Full access to all non-admin endpoints. Recommended for AI assistants and plugins.

The AGENT_FULL scope grants access to all task, schedule, project, calendar, compass, timer, habit, memory, gamification, household, and conversation endpoints. This is the recommended scope for integrations like the OpenClaw plugin.

Granular Scopes

For more restrictive access, you can assign individual scopes:

Scope	Endpoints	Description
TASKS_LIST	GET /api/tasks	List tasks
TASKS_VIEW	GET /api/tasks/{id}	View task details
TASKS_CREATE	POST /api/tasks/create	Create tasks
TASKS_UPDATE	PUT /api/tasks	Update tasks
TASKS_DELETE	DELETE /api/tasks/{id}	Delete tasks
TASKS_CALENDAR	Task calendar operations	Add/update tasks in calendar
SCHEDULES_LIST	GET /api/schedules	List schedules
SCHEDULES_VIEW	GET /api/schedules/{id}	View schedule
SCHEDULES_CREATE	POST /api/schedules	Create schedules
SCHEDULES_UPDATE	PUT /api/schedules/{id}	Update schedules
SCHEDULES_DELETE	DELETE /api/schedules/{id}	Delete schedules
PROJECTS_LIST	GET /api/project	List projects
PROJECTS_VIEW	GET /api/project/{id}	View project details
PROJECTS_CREATE	POST /api/project/create	Create projects
PROJECTS_UPDATE	PUT /api/project/{id}	Update projects
PROJECTS_DELETE	DELETE /api/project/{id}	Delete projects
USER_READ	GET /api/user	Read user profile

API Key Management

• Create: Settings → API Keys → Create New Key
• Revoke: Click the revoke button next to any active key
• Rate Limiting: API keys are rate-limited per key to prevent abuse
• Security: Keys are hashed at rest. The full key is only shown once at creation — store it securely.

Refer to the Swagger UI for request/response schemas, parameters, and example payloads.

Featured Endpoints

Calendar Meeting Actions

Control your calendar meetings programmatically with our meeting action endpoints.

Skip Meeting

POST /api/v2/calendar/events/{eventId}/skip

Description: Skip a meeting without sending external notifications. This is a personal preference that doesn't affect the calendar event or notify other attendees.

Parameters:

• eventId (path, required): The calendar event ID

Request Body:

{
  "meetingId": "string",
  "skipReason": "string (optional)"
}

Response: MeetingActionResponseDTO

{
  "success": true,
  "message": "Meeting marked as skipped",
  "meetingId": "string",
  "action": "skip"
}

Use Cases:

• Skip optional recurring meetings
• Mark meetings as not attending without formal decline
• Personal time management without external notifications

---

Decline Meeting

POST /api/v2/calendar/events/{eventId}/decline

Description: Decline a calendar invitation. This sends a decline notification through your connected calendar (Google Calendar or Microsoft Outlook) to the organizer and attendees.

Parameters:

• eventId (path, required): The calendar event ID

Request Body:

{
  "eventId": "string",
  "declineReason": "string (optional)"
}

Response: MeetingActionResponseDTO

Requirements:

• User must be an attendee (not the organizer)
• Connected calendar account required (Google or Microsoft)

Use Cases:

• Formally decline meeting invitations
• Respond to double-bookings
• Communicate schedule conflicts professionally

---

Cancel Meeting

POST /api/v2/calendar/events/{eventId}/cancel

Description: Cancel an entire meeting (organizer only). This sends cancellation notifications through your connected calendar to all attendees.

Parameters:

• eventId (path, required): The calendar event ID

Request Body:

{
  "eventId": "string",
  "cancellationReason": "string (optional)"
}

Response: MeetingActionResponseDTO

Requirements:

• User must be the meeting organizer
• Connected calendar account required (Google or Microsoft)

Use Cases:

• Cancel meetings you organized
• Notify all attendees professionally
• Free up calendar time for all participants

---

Authentication Notes

All calendar meeting action endpoints require:

• Authentication: Valid JWT session token or API key with AGENT_FULL scope
• Calendar Connection: Active Google Calendar or Microsoft Outlook integration
• Permissions: Appropriate permissions for the calendar event (attendee for decline, organizer for cancel)

Error Responses

All endpoints return standard error responses:

400 Bad Request: Invalid request parameters

{
  "success": false,
  "message": "Invalid request parameters",
  "action": "decline"
}

401 Unauthorized: Missing or invalid authentication

{
  "error": "Unauthorized",
  "message": "Valid authentication required"
}

403 Forbidden: Insufficient permissions

{
  "success": false,
  "message": "Only meeting organizers can cancel meetings",
  "action": "cancel"
}

404 Not Found: Event not found

{
  "success": false,
  "message": "Calendar event not found",
  "action": "skip"
}

500 Internal Server Error: Server-side failure

{
  "success": false,
  "message": "Internal server error while processing meeting action",
  "action": "decline"
}

---

AI Assistant & Plugin Integration

Mind Your Now's API is designed for integration with AI assistants and automation tools. With an AGENT_FULL API key, your AI assistant can:

• Manage tasks: Create, update, complete, and search tasks
• Run compass briefings: Generate and review daily prioritization
• Control timers: Start Pomodoro sessions, set alarms and countdowns
• Access memories: Store and recall contextual notes
• View calendar: See upcoming events and meetings
• Track habits: Log habit completions and view streaks
• Manage households: View chores, assignments, and shared tasks

Supported Endpoints

All v2 and v1 endpoints are accessible with AGENT_FULL scope, including:

Endpoint Group	Path
Unified Tasks	/api/v2/unified-tasks/**
Compass	/api/v2/compass/**
Timers	/api/v2/timers/**
Search	/api/v2/search
Calendar	/api/calendar/**
Schedules	/api/schedules/**
Projects	/api/project/**
Habits & Reminders	/api/v1/habit-reminders/**, /api/v1/habit-chains/**
Households & Chores	/api/v1/households/**, /api/v1/chores/**
Customer Profile	/api/v1/customers
Memories	/api/v1/customers/memories/**
Conversations	/api/v1/conversations/**
Gamification	/api/v1/gamification/**
Task Sharing	/api/v1/tasks/sharing/**
Task Comments	/api/v2/tasks/{id}/comments/**

---

For complete API documentation including all endpoints, schemas, and interactive testing, visit our Swagger UI.