{"title":"MyApi Quick Start for AI Agents","important":"STOP — before performing ANY action, you MUST ask the human user for explicit approval. Describe what you intend to do and wait for confirmation. Never call endpoints, reveal tokens, or execute services without the user saying \"yes\". This applies to every request.","authenticated":false,"canonicalBaseUrl":"https://myapi.techdigital.ci","urlWarning":"Always use this exact base URL for all API calls. Do NOT follow redirects — HTTP redirects strip Authorization headers and will result in auth failures. IMPORTANT: Do NOT append /api/v1 to this base URL — all endpoint paths in this guide already include /api/v1. A common mistake is setting a base URL of https://www.myapiai.com/api/v1 and then calling /api/v1/skills — that produces a double-prefix (https://www.myapiai.com/api/v1/api/v1/skills) which returns ROUTE_NOT_FOUND.","prerequisite":{"action":"Ask the human for approval before every action","detail":"You MUST describe what you plan to do and wait for the human user to explicitly approve before calling any endpoint. Never proceed without confirmation. This is mandatory for all actions.","required":true},"noTokenFlow":{"description":"Your token is missing or was rejected. Request access in two steps — no username or extra info needed:","steps":[{"step":1,"action":"Submit a handshake request (no auth required)","method":"POST","endpoint":"/api/v1/handshakes","body":{"agentId":"<unique-id-for-your-agent>","requestedScopes":["read"],"message":"<briefly describe who you are>"},"allowedScopes":["read","professional","availability"],"returns":"handshakeId — save this for step 2"},{"step":2,"action":"Poll until approved (no auth required)","method":"GET","endpoint":"/api/v1/handshakes/:handshakeId/status","returns":"status: pending | approved | denied","note":"When approved, the owner will share a new token with you. Use it as your Bearer token."}]},"steps":[{"step":1,"action":"Authenticate","detail":"Add header: Authorization: Bearer <token>. Use https://myapi.techdigital.ci as the base URL directly — do not rely on redirects.","done":false},{"step":2,"action":"Load your full context — START HERE","endpoint":"GET /api/v1/gateway/context","detail":"Returns everything you need in one call: who you are (persona + soul_content), who you are serving (user identity), long-term memory (DB entries with IDs + timestamps), connected services, and the complete list of endpoints available to your token. Always call this first.","critical":true},{"step":3,"action":"Check your token permissions","endpoint":"GET /api/v1/tokens/me/capabilities","detail":"See what scopes your token grants access to."},{"step":4,"action":"Store memory for future sessions","endpoint":"POST /api/v1/memory","detail":"Write freeform markdown notes that persist across AI sessions. Any AI that calls gateway/context will see these entries (with id + timestamp), enabling seamless context handoff between different AI assistants.","body":{"content":"<markdown text to remember>"}},{"step":5,"action":"Explore the knowledge base","endpoint":"GET /api/v1/brain/knowledge-base","detail":"Read documents stored by the owner (identity, preferences, skills, etc).","requiredScope":"knowledge"},{"step":6,"action":"Chat with the AI brain","endpoint":"POST /api/v1/brain/chat","detail":"Send messages to the owner's AI brain. Your persona instructions from step 2 are automatically applied.","requiredScope":"chat","body":{"message":"<your message>","conversationId":"<optional — omit to start new>"}},{"step":7,"action":"Proxy connected OAuth services","endpoint":"GET /api/v1/services/:service/*","detail":"Call any connected service (github, google, slack, etc.) through the proxy using the owner's stored credentials.","requiredScope":"services:read"}],"fullDocs":"/openapi.json"}