Introduction
Platform APIs — organization-wide access to manage projects, training, contacts, and more using API Tokens.
Platform APIs provide complete, organization-wide access to the YourGPT platform. Use an API Token (Bearer header) to manage organizations, multi-project operations, training data, contacts, conversations, analytics, and more — across all your chatbot projects.
Platform APIs are available on Advanced, Agency, and Enterprise plans.
Base URL: https://api.yourgpt.ai/chatbot/v1 (project-level) · https://api.yourgpt.ai/api/v1 (organization-level)
Make your first request
Every request needs your token in the Authorization header and a JSON body (even if it's empty).
Let's start by listing your projects:
curl -X POST https://api.yourgpt.ai/chatbot/v1/getMyProjects \
-H "Authorization: Bearer api-v1-your_token_here" \
-H "Content-Type: application/json" \
-d '{}'{
"type": "RXSUCCESS",
"message": "Data Fetched Successfully!",
"total": 3,
"data": [...]
}The project_uid from each project in the response is what you'll pass to project-level endpoints going forward.
Organization-level endpoints don't need a project_uid — your token already identifies your organization.
Available endpoints
Organization
Invite members, assign roles, and manage your team.
Projects
List, create, update, and delete chatbot projects.
Project Usage
View and control per-project resource limits.
Analytics
Session stats, visitor stats, sentiment, intents, and AI resolution.
Training
Add, update, and remove knowledge base sources — URLs, text, files, and tags.
Conversations
Create sessions, send messages, and manage conversations.
Contacts
Create, import, tag, and organize your contact data.
Debugging
Search your knowledgebase and view AI execution logs.
Agent Playground
Test your AI agent with interactive playground sessions.