Skip to main content
All REST API requests use bearer authentication. Create tokens in the Mentionpath app under Account → API, or connect an MCP client and complete the OAuth flow — both issue tokens scoped to your organization.

​
Base URL

https://api.mentionpath.ai/api/v1

​
API tokens

  1. Open Account → API in the app.
  2. Choose the scopes your integration needs (read-only scopes are preselected).
  3. Create a token and copy the secret — it is shown once.
Send the token on every request: 
curl -sS \
  -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.mentionpath.ai/api/v1/domains

​
OAuth (MCP clients)

Hosted MCP clients (Claude, ChatGPT, Cursor, and others) use OAuth instead of manual tokens. Discovery metadata is published at:
  • https://api.mentionpath.ai/.well-known/oauth-authorization-server
  • https://api.mentionpath.ai/.well-known/oauth-protected-resource
The MCP endpoint is https://api.mentionpath.ai/mcp (Streamable HTTP, POST only). See the MCP tab for client setup.

​
Idempotency

Include an Idempotency-Key header on write requests (POST, PATCH, DELETE) to safely retry without duplicating work: 
curl -sS -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: create-prompt-001" \
  -H "Content-Type: application/json" \
  -d '{"title":"Best CRM for startups"}' \
  https://api.mentionpath.ai/api/v1/domains/DOMAIN_ID/prompts

​
Errors

HTTP statusMeaning
401Missing or invalid token
403Token lacks the required scope or domain access
404Resource not found
202Write accepted but requires human approval
429Rate limited