{"version":"0.10","base_url":"https://mcptask.online/api","mcp_endpoint":"POST https://mcptask.online/mcp","authentication":{"description":"JWT Bearer token authentication","header":"Authorization: Bearer \u003ctoken\u003e","obtain_token":"POST https://mcptask.online/api/sessions"},"oauth":{"discovery":{"path":"GET /.well-known/oauth-authorization-server","req":[]},"register":{"path":"POST /oauth/register","req":["client_name","redirect_uris"],"opt":["client_uri","logo_uri","scope"]},"authorize":{"path":"GET /oauth/authorize","req":["response_type","client_id","redirect_uri"],"opt":["scope","state","code_challenge","code_challenge_method"]},"token":{"path":"POST /oauth/token","req":["grant_type","code","redirect_uri","client_id"],"opt":["code_verifier","refresh_token","client_secret"]}},"endpoints":{"sessions":{"create":{"path":"POST /api/sessions","req":["session[email]","session[password]"]},"destroy":{"path":"DELETE /api/sessions/:id","req":[":id"]}},"accounts":{"show":{"path":"GET /api/:code","req":[":code"]}},"pieces":{"show":{"path":"GET /api/:code/pieces/:id","req":[":code",":id"]},"pinned":{"path":"GET /api/:code/pieces/pinned","req":[":code"]},"last":{"path":"GET /api/:code/pieces/last","req":[":code"]},"search":{"path":"GET /api/:code/pieces/search","req":[":code"],"opt":["search[text]"]},"next":{"path":"GET /api/:code/pieces/next","req":[":code"],"opt":["project_id","exclude_relative_ids"]},"next_subtask":{"path":"GET /api/:code/pieces/:id/next","req":[":code",":id"],"opt":["exclude_relative_ids"]},"create":{"path":"POST /api/:code/pieces","req":[":code","piece_type","name","project_id"],"opt":["description","parent_id","task_type_code","assigned_user_id","priority_code","scrum_point_code","sprint_id","repeat_after","repeat_on","files[]","for_errors (Epic only)"]},"update":{"path":"PATCH /api/:code/pieces/:id","req":[":code",":id"],"opt":["name","description","task_type_code","assigned_user_id","priority_code","scrum_point_code","sprint_id","for_errors (Epic only)"]}},"efforts":{"index":{"path":"GET /api/:code/pieces/:piece_id/efforts","req":[":code",":piece_id"]},"show":{"path":"GET /api/:code/pieces/:piece_id/efforts/:id","req":[":code",":piece_id",":id"]},"create":{"path":"POST /api/:code/pieces/:piece_id/efforts","req":[":code",":piece_id","effort[description]","effort[progress]","effort[begin_at]","effort[end_at]"]},"update":{"path":"PATCH /api/:code/pieces/:piece_id/efforts/:id","req":[":code",":piece_id",":id"],"opt":["effort[description]","effort[progress]","effort[begin_at]","effort[end_at]"]},"destroy":{"path":"DELETE /api/:code/pieces/:piece_id/efforts/:id","req":[":code",":piece_id",":id"]}},"users":{"show":{"path":"GET /api/:code/users/:id","req":[":code",":id"]},"current":{"path":"GET /api/:code/users/current","req":[":code"]},"time_status":{"path":"GET /api/:code/users/:id/time_status","req":[":code",":id"]}},"projects":{"index":{"path":"GET /api/:code/projects","req":[":code"]}},"attachments":{"create":{"path":"POST /api/:code/pieces/:piece_id/attachments","req":[":code",":piece_id","file"]},"download":{"path":"GET /api/:code/pieces/:piece_id/attachments/:id/download","req":[":code",":piece_id",":id"]},"destroy":{"path":"DELETE /api/:code/pieces/:piece_id/attachments/:id","req":[":code",":piece_id",":id"],"res":["204 No Content"]}},"bug_reports":{"create":{"path":"POST /api/:code/bug_reports","auth":"Authorization: Bearer \u003cbug report key\u003e","req":[":code","title","description"],"opt":["expected_behavior","url","user_agent","viewport","reporter_name","reporter_email","console_log","html_snapshot","screenshot (multipart file or base64 data URL)","files[] (multipart files or base64 data URLs)","assigned_user_id (overrides the key default)","priority_code (default high)"],"res":["201 Created { relative_id, url }"],"errors":["401 invalid_bug_report_key","402 trial_expired","403 plan_upgrade_required","413 upload_too_large (10 MB combined)","422 validation_error","429 Too Many Requests (30 reports per 10 minutes per key, Retry-After header)"],"guide":"https://mcptask.online/integrations/developers?language=en#bug-report-api"}},"events":{"show":{"path":"GET /api/:code/events/:id","req":[":code",":id"]},"last":{"path":"GET /api/:code/events/last","req":[":code"]}}},"examples":{"sessions.create":{"session":{"email":"user@x.com","password":"secret"}},"pieces.create":{"piece_type":"Task","name":"New Task","project_id":1},"efforts.create":{"effort":{"description":"Work","begin_at":"2026-04-20T10:00:00Z","end_at":"2026-04-20T11:00:00Z","progress":50}},"bug_reports.create":{"title":"Save button does nothing","description":"Clicking Save on the invoice form has no effect.","url":"https://app.example.com/invoices/1","priority_code":"urgent"},"efforts.update":{"effort":{"description":"Updated","progress":75}}}}