{"openapi":"3.1.0","info":{"title":"틸더스 앱스 API (Tuilders Apps)","version":"1.0.0","description":"틸더스 앱스(Tuilders Apps) — 교사가 만든 수업 · 업무 앱을 모아 두는 곳입니다. 앱 등록은 에이전트가 합니다.\nTuilders Apps is an archive of apps built by Korean teachers. Agents register and manage apps here.\n\n앱 등록 순서 (registration flow):\n1. list_curriculum — 교육용(education) 앱이면 학교급 · 학년 · 교과 · 영역 코드를 먼저 확인합니다. (Get valid curriculum codes.)\n2. register_app { …, dry_run: true } — 저장하지 않고 검증만 합니다. 오류의 `allowed`를 보고 고쳐서 다시 보냅니다. (Validate without saving; fix using `allowed`.)\n   본인 제작 확인: 선생님이 직접 만든 앱만 등록됩니다. 실제 등록 전에 선생님께 \"이 앱은 제가 직접 만든 앱이에요. 다른 사람이 만든 앱을 대신 등록하지 않아요.\" 문장을 보여 주고 직접 물어보세요. 분명히 \"네\"라고 답했을 때만 confirm_own_work: true를 넣습니다. 스스로 판단하거나 추측해서 넣지 마세요. (Ask the teacher explicitly; never set confirm_own_work on your own.)\n3. register_app { …, confirm_own_work: true } — 실제 등록. 같은 URL을 다시 보내면 기존 앱을 돌려줍니다. 재시도에는 idempotency_key를 쓰세요. (Same URL returns the existing app.)\n4. upload_media — icon(정사각 512×512) 과 thumbnail(1600×1000)을 올립니다. `url` 또는 `data_base64`. theme light|dark. (Upload icon 512² and thumbnail 1600×1000.)\n5. 새 버전은 add_version, 정보 수정은 update_app. (New releases: add_version; edits: update_app.)\n수업 준비: find_apps_for_lesson { level, grade, subject, topic } 으로 오늘 수업에 맞는 앱을 이유와 함께 찾고, add_launchpad_item으로 학급 런치패드에 담습니다. (Lesson prep: find_apps_for_lesson.)\n\n\"오늘 수업 앱 추천해서 런치패드에 띄워\" 같은 부탁:\n1) pick_lesson_app_to_launchpad { level, grade, subject, topic } 한 번 (또는 find_apps_for_lesson → add_launchpad_item { app_slug, position: \"first\" }).\n2) LAUNCHPAD_AMBIGUOUS가 오면 allowed의 반 이름을 보여 주고 선생님께 어느 반인지 물은 뒤 launchpad를 넣어 다시 부릅니다.\n3) NO_LAUNCHPAD가 오면 create_launchpad(예: name \"오늘 수업\")를 권하고, 만든 뒤 다시 부릅니다.\n4) 결과의 message와 launchpad.student_link를 선생님께 전합니다. 다른 앱이 좋으면 pick: 2 또는 alternatives.\n(Recipe: pick_lesson_app_to_launchpad; on LAUNCHPAD_AMBIGUOUS ask which class; on NO_LAUNCHPAD offer create_launchpad.)\n\n분류 규칙 (classification): purpose=education → curriculum 1–3행 필수, category 금지. purpose=general → category 필수 (classroom|automation|counseling|assessment|game|utility).\ncurriculum 행: { level: elementary|middle, grades: 초등 1-2·3-4·5-6 / 중 1·2·3, subject, areas }. subject=creative-activities(창의적 체험활동)는 areas를 보내지 않습니다. 그 밖의 교과는 areas가 1개 이상이고 모두 그 교과의 영역 코드여야 합니다.\n\n인증 (auth): 읽기 도구는 토큰 없이 됩니다. 쓰기는 Authorization: Bearer tld_live_… 토큰이 필요합니다 (https://tuilders.com/settings/tokens 에서 발급, scopes: apps:write, social:write, profile:read, profile:write, launchpad:write).\n런치패드(학급별 학생용 앱 모음, scope launchpad:write): create_launchpad → add_launchpad_item { app_slug } 또는 { url, title } → 결과의 link(https://tuilders.com/l/<code>)를 학생에게. 학생은 로그인 없이 담긴 앱만 엽니다. (Launchpads: per-class student links to teacher-approved apps.)\n하이프는 사용자 · 앱마다 하루(Asia/Seoul) 5회, 본인 앱은 안 됩니다. 큐레이터의 하이프 · 추천은 가중치 3입니다.\n알림: list_notifications(댓글 · 답글 · 하이프 · 추천 · 큐레이터 픽 · 팔로우, profile:read), mark_notifications_read(profile:write). (Notifications.)\n모든 쓰기 도구는 dry_run을 받습니다. 오류는 { code, message, field?, allowed? } 형식의 도구 오류로 돌아옵니다. (All writes accept dry_run; errors carry code/field/allowed.)\nREST: https://tuilders.com/api/v1 · OpenAPI: https://tuilders.com/api/v1/openapi.json · 안내: https://tuilders.com/llms.txt\n\n규칙 요약: 하이프는 사용자 · 앱마다 하루 5회(Asia/Seoul), 큐레이터 가중치 3, 큐레이터 한 줄 평 ≤100자, creative-activities에는 areas가 없습니다.\n오류 본문은 항상 `Error` 스키마 `{ code, message, field?, allowed?, details? }` 입니다."},"servers":[{"url":"https://tuilders.com/api/v1"}],"externalDocs":{"description":"llms.txt (agent guide)","url":"https://tuilders.com/llms.txt"},"tags":[{"name":"curriculum","description":"교과 · 영역 코드 (2022 개정 교육과정)"},{"name":"apps","description":"앱 등록 · 수정 · 미디어 · 버전"},{"name":"social","description":"하이프 · 추천 · 랭킹 · 큐레이터"},{"name":"community","description":"댓글 · 게시판 · 투표"},{"name":"profile","description":"내 프로필 · 사용자"},{"name":"notifications","description":"알림 — 댓글 · 답글 · 하이프 · 추천 · 큐레이터 픽 · 팔로우"},{"name":"launchpads","description":"런치패드 — 학급별 학생용 앱 모음 (학생 링크 /l/{code}, 실행 /l/{code}/go/{item_id})"}],"components":{"schemas":{"Error":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_FAILED","REQUIRED","INVALID_TYPE","INVALID_VALUE","INVALID_FORMAT","TOO_LONG","TOO_SHORT","TOO_MANY","TOO_FEW","UNKNOWN_FIELD","CURRICULUM_REQUIRED","CURRICULUM_TOO_MANY","CURRICULUM_NOT_ALLOWED","CURRICULUM_DUPLICATE","INVALID_LEVEL","INVALID_GRADE","GRADES_REQUIRED","SUBJECT_NOT_IN_LEVEL","AREAS_REQUIRED","AREAS_NOT_ALLOWED","AREA_NOT_IN_SUBJECT","CATEGORY_REQUIRED","CATEGORY_NOT_ALLOWED","INVALID_CATEGORY","UNAUTHORIZED","FORBIDDEN","ONBOARDING_REQUIRED","INSUFFICIENT_SCOPE","TOKEN_INVALID","NOT_FOUND","APP_NOT_FOUND","POST_NOT_FOUND","COMMENT_NOT_FOUND","USER_NOT_FOUND","CHANNEL_NOT_FOUND","CONFLICT","SLUG_TAKEN","HANDLE_TAKEN","NICKNAME_TAKEN","VERSION_EXISTS","OWN_APP","HYPE_DAILY_LIMIT","NOTE_CURATOR_ONLY","COMMENT_DEPTH_LIMIT","COMMENT_DELETED","PARENT_TARGET_MISMATCH","SELF_FOLLOW","PROFILE_LINKS_LIMIT","LAST_ADMIN","OWN_WORK_CONFIRMATION_REQUIRED","UNSUPPORTED_MEDIA_TYPE","MEDIA_TOO_LARGE","SCREENSHOT_LIMIT","LAUNCHPAD_NOT_FOUND","LAUNCHPAD_ITEM_NOT_FOUND","LAUNCHPAD_LIMIT","LAUNCHPAD_ITEMS_LIMIT","LAUNCHPAD_PAUSED","DUPLICATE_ITEM","NO_LAUNCHPAD","LAUNCHPAD_AMBIGUOUS","RATE_LIMITED","INTERNAL"]},"message":{"type":"string"},"field":{"type":"string"},"allowed":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","null"]}}]}},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","enum":["VALIDATION_FAILED","REQUIRED","INVALID_TYPE","INVALID_VALUE","INVALID_FORMAT","TOO_LONG","TOO_SHORT","TOO_MANY","TOO_FEW","UNKNOWN_FIELD","CURRICULUM_REQUIRED","CURRICULUM_TOO_MANY","CURRICULUM_NOT_ALLOWED","CURRICULUM_DUPLICATE","INVALID_LEVEL","INVALID_GRADE","GRADES_REQUIRED","SUBJECT_NOT_IN_LEVEL","AREAS_REQUIRED","AREAS_NOT_ALLOWED","AREA_NOT_IN_SUBJECT","CATEGORY_REQUIRED","CATEGORY_NOT_ALLOWED","INVALID_CATEGORY","UNAUTHORIZED","FORBIDDEN","ONBOARDING_REQUIRED","INSUFFICIENT_SCOPE","TOKEN_INVALID","NOT_FOUND","APP_NOT_FOUND","POST_NOT_FOUND","COMMENT_NOT_FOUND","USER_NOT_FOUND","CHANNEL_NOT_FOUND","CONFLICT","SLUG_TAKEN","HANDLE_TAKEN","NICKNAME_TAKEN","VERSION_EXISTS","OWN_APP","HYPE_DAILY_LIMIT","NOTE_CURATOR_ONLY","COMMENT_DEPTH_LIMIT","COMMENT_DELETED","PARENT_TARGET_MISMATCH","SELF_FOLLOW","PROFILE_LINKS_LIMIT","LAST_ADMIN","OWN_WORK_CONFIRMATION_REQUIRED","UNSUPPORTED_MEDIA_TYPE","MEDIA_TOO_LARGE","SCREENSHOT_LIMIT","LAUNCHPAD_NOT_FOUND","LAUNCHPAD_ITEM_NOT_FOUND","LAUNCHPAD_LIMIT","LAUNCHPAD_ITEMS_LIMIT","LAUNCHPAD_PAUSED","DUPLICATE_ITEM","NO_LAUNCHPAD","LAUNCHPAD_AMBIGUOUS","RATE_LIMITED","INTERNAL"]},"message":{"type":"string"},"field":{"type":"string"},"allowed":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number","null"]}}]}},"details":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["code","message"],"additionalProperties":false}}},"required":["code","message"],"additionalProperties":false}},"securitySchemes":{"agentToken":{"type":"http","scheme":"bearer","bearerFormat":"tld_live_…","description":"에이전트 토큰. https://tuilders.com/settings/tokens 에서 발급. scopes: apps:write, social:write, profile:read, profile:write, launchpad:write."}},"parameters":{}},"paths":{"/curriculum":{"get":{"operationId":"listCurriculum","summary":"교과 · 영역 코드 보기 (List curriculum codes)","description":"2022 개정 교육과정의 학교급 · 학년(군) · 교과 · 영역 코드와 일반용 category 목록을 돌려줍니다. register_app 전에 먼저 부르세요.\nlevel(elementary|middle), subject로 좁힐 수 있습니다. creative-activities(창의적 체험활동)는 영역이 없습니다.\nReturns levels, grades, subjects, area codes and general-app categories. Call this before register_app.\n\nMCP tool: `list_curriculum`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["curriculum"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"list_curriculum","parameters":[{"schema":{"type":"string"},"required":false,"name":"level","in":"query"},{"schema":{"type":"string"},"required":false,"name":"subject","in":"query"}],"responses":{"200":{"description":"List curriculum codes","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps":{"get":{"operationId":"searchApps","summary":"앱 찾기 (Search apps)","description":"공개된 앱을 찾습니다. q(제목 · 한 줄 소개 부분 일치), purpose, level, subject, area, grade, category, owner(handle)로 거르고 sort로 정렬합니다.\nsort: weekly(이번 주 점수, 기본) · live(최근 60분 하이프) · all(누적 하이프) · new(최신) · updated · recommended. 다음 쪽은 next_cursor를 cursor로 보내세요.\nSearch published apps. sort=live|weekly|all|new (all = all-time hype). Paginate with cursor = next_cursor.\n\nMCP tool: `search_apps`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["apps"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"search_apps","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","maxLength":100},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","enum":["education","general"]},"required":false,"name":"purpose","in":"query"},{"schema":{"type":"string"},"required":false,"name":"level","in":"query"},{"schema":{"type":"string","maxLength":40},"required":false,"name":"subject","in":"query"},{"schema":{"type":"string","maxLength":80},"required":false,"name":"area","in":"query"},{"schema":{"type":"string","maxLength":8},"required":false,"name":"grade","in":"query"},{"schema":{"type":"string"},"required":false,"name":"category","in":"query"},{"schema":{"type":"string","maxLength":32},"required":false,"name":"owner","in":"query"},{"schema":{"type":"string","enum":["weekly","live","all","hype","new","updated","recommended"]},"required":false,"name":"sort","in":"query"}],"responses":{"200":{"description":"Search apps","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"registerApp","summary":"앱 등록 (Register app)","description":"새 앱을 등록합니다. 선생님이 직접 만든 앱만 등록할 수 있습니다. 먼저 dry_run: true로 검증하고, 오류의 allowed 목록을 보고 고친 뒤 실제로 보내세요.\n본인 제작 확인(필수): confirm_own_work: true가 있어야 등록됩니다. 실제 등록 전에 반드시 선생님께 \"이 앱은 제가 직접 만든 앱이에요. 다른 사람이 만든 앱을 대신 등록하지 않아요.\" 문장을 보여 주고 직접 물어보세요. 선생님이 분명히 \"네\"라고 답했을 때만 true로 보내고, 에이전트가 스스로 판단하거나 추측해서 넣으면 안 됩니다. 없으면 422 OWN_WORK_CONFIRMATION_REQUIRED(details에 statement · policy_version). dry_run은 이 값 없이도 검증하고 requires_confirmation: true와 own_work_policy를 돌려줍니다. 확인은 날짜 · 경로와 함께 기록됩니다.\nOwn-work confirmation (required): ask the teacher explicitly before setting confirm_own_work: true — never set it on your own or infer it.\npurpose=education → curriculum 1–3행 필수, category 금지. purpose=general → category 필수 (classroom|automation|counseling|assessment|game|utility), curriculum 금지.\ncurriculum 행 = { level: elementary|middle, grades: 초등 1-2·3-4·5-6 / 중 1·2·3, subject, areas }. subject=creative-activities(창의적 체험활동)는 areas를 보내지 않습니다. 그 밖의 교과는 areas ≥1, 모두 그 학교급 · 교과의 영역 코드(list_curriculum).\nEducation apps need 1–3 curriculum rows and no category; general apps need a category and no curriculum. creative-activities has no areas.\n같은 사용자가 같은 url을 다시 보내면 새로 만들지 않고 기존 앱을 돌려줍니다(created: false). 재시도에는 Idempotency-Key(REST 헤더) 또는 idempotency_key(MCP)를 쓰세요.\n등록 뒤 upload_media로 icon(512×512)과 thumbnail(1600×1000)을 올리세요.\nRegister an app (scope apps:write). Same URL by the same user returns the existing app. Then upload icon 512² and thumbnail 1600×1000.\n\nMCP tool: `register_app`\n\n인증 필요 — 토큰 scope `apps:write`. (Requires auth, scope apps:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)\n\n`Idempotency-Key` 헤더를 보내면 24시간 안의 재시도에 같은 결과를 돌려줍니다 (`Idempotent-Replayed: true`). (Idempotent retries for 24 h.)","tags":["apps"],"security":[{"agentToken":["apps:write"]}],"x-mcp-tool":"register_app","parameters":[{"schema":{"type":"string","maxLength":200},"required":false,"name":"Idempotency-Key","in":"header"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":40},"tagline":{"type":"string","maxLength":60,"default":""},"description":{"type":"string","maxLength":5000,"default":""},"url":{"type":"string","maxLength":500,"format":"uri"},"purpose":{"type":"string","enum":["education","general"]},"category":{"type":["string","null"]},"curriculum":{"type":["array","null"],"items":{"type":"object","properties":{"level":{"type":"string","minLength":1},"grades":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"subject":{"type":"string","minLength":1},"areas":{"type":"array","items":{"type":"string"}}},"required":["level","subject"],"additionalProperties":false}},"slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"stack":{"type":"array","items":{"type":"string","minLength":1,"maxLength":30},"maxItems":12,"default":[]},"built_with":{"type":"string","minLength":1,"maxLength":60},"version":{"type":"string"},"release_note":{"type":"string","maxLength":2000},"confirm_own_work":{"type":"boolean","description":"본인 제작 확인. 반드시 선생님께 \"이 앱은 제가 직접 만든 앱이에요. 다른 사람이 만든 앱을 대신 등록하지 않아요.\" 문장을 보여 주고 직접 물어본 뒤, 선생님이 분명히 \"네\"라고 답했을 때만 true로 보내세요. 에이전트가 스스로 판단하거나 추측해서 넣으면 안 됩니다. (Ask the teacher explicitly first; never set this on your own or infer it.)"},"dry_run":{"type":"boolean"},"idempotency_key":{"type":"string","maxLength":200,"description":"MCP only: retry-safe key (same as the REST Idempotency-Key header)"}},"required":["title","url","purpose"],"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Register app","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"본인 제작 확인 필요 (OWN_WORK_CONFIRMATION_REQUIRED) — `details.statement`를 선생님께 보여 주고 직접 물어본 뒤, 분명히 \"네\"일 때만 `confirm_own_work: true`로 다시 보내세요. (Ask the teacher; never infer.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/lesson-picks":{"get":{"operationId":"findAppsForLesson","summary":"오늘 수업에 맞는 앱 찾기 (Find apps for a lesson)","description":"오늘 수업(학교급 · 학년 · 교과 · 영역 · 주제)에 맞는 틸더스 앱을 점수순으로 추천합니다. 모든 조건은 선택이고 한국어도 받습니다(level: 초/중, grade: \"3학년\" · \"중2\" · \"3-4\", subject: \"수학\", topic: \"분수의 크기 비교\").\n점수(0–100): 교육과정 일치 ≤50(학교급 10 + 교과 20 + 학년 10 + 영역 10) · 주제 관련도 ≤25(pg_trgm 유사도 + 낱말 일치) · 큐레이터 추천 ≤15 · 이번 주 인기 ≤10 · 최근 등록 ≤5, 수업 시간(minutes)에 맞는 활동 +3. 각 앱의 reasons에 이유가 한국어로 붙습니다.\n결과가 없으면 오류가 아니라 빈 items와 message를 돌려줍니다. 고른 앱은 add_launchpad_item으로 학급 런치패드에 담을 수 있습니다.\nRecommend apps for a lesson (no auth). Score = curriculum ≤50 + topic ≤25 + curator ≤15 + weekly popularity ≤10 + recency ≤5 (+3 minutes fit).\n\nMCP tool: `find_apps_for_lesson`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["apps"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"find_apps_for_lesson","parameters":[{"schema":{"type":"string","maxLength":20},"required":false,"name":"level","in":"query"},{"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"integer"}]},"required":false,"name":"grade","in":"query"},{"schema":{"type":"string","maxLength":40},"required":false,"name":"subject","in":"query"},{"schema":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":80},"maxItems":10},{"type":"string","maxLength":400}]},"required":false,"name":"areas","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"topic","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":600},"required":false,"name":"minutes","in":"query"},{"schema":{"type":"string","enum":["education","general"]},"required":false,"name":"purpose","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":20,"default":5},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"Find apps for a lesson","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/lesson-pick":{"post":{"operationId":"pickLessonAppToLaunchpad","summary":"수업 앱 골라 런치패드 맨 앞에 띄우기 (Pick a lesson app onto a launchpad)","description":"\"오늘 수업할 앱 하나 추천해서 런치패드에 띄워\"를 한 번에 합니다: find_apps_for_lesson과 같은 입력(level, grade, subject, areas, topic, minutes)으로 앱을 고르고, pick번째(기본 1 = 가장 잘 맞는 앱)를 런치패드 맨 앞에 담습니다. 이미 담긴 앱이면 맨 앞으로 옮깁니다.\nlaunchpad: id · 코드 · 이름(예: \"3학년 2반\"). 런치패드가 하나면 생략. 여러 개인데 생략하면 409 LAUNCHPAD_AMBIGUOUS(allowed = [{id,name,code}]) → 선생님께 어느 반인지 물어보세요. 하나도 없으면 409 NO_LAUNCHPAD → create_launchpad를 권하세요.\n맞는 앱이 없으면 오류가 아니라 placed: false와 message. dry_run: true면 같은 결과를 미리 보여 주고 저장하지 않습니다. 결과의 launchpad.student_link를 학생에게 주세요.\nOne call for \"pick an app for today's lesson and put it on my launchpad\" (scope launchpad:write): scores apps like find_apps_for_lesson and puts the chosen one FIRST on the launchpad.\n\nMCP tool: `pick_lesson_app_to_launchpad`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"pick_lesson_app_to_launchpad","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"level":{"type":"string","maxLength":20},"grade":{"anyOf":[{"type":"string","maxLength":20},{"type":"integer"}]},"subject":{"type":"string","maxLength":40},"areas":{"anyOf":[{"type":"array","items":{"type":"string","maxLength":80},"maxItems":10},{"type":"string","maxLength":400}]},"topic":{"type":"string","maxLength":200},"minutes":{"type":"integer","minimum":1,"maximum":600},"launchpad":{"type":"string","minLength":1,"maxLength":50,"description":"런치패드 id · 코드 · 이름(예: \"3학년 2반\"). 런치패드가 하나뿐이면 생략"},"pick":{"type":"integer","minimum":1,"maximum":10,"default":1},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Pick a lesson app onto a launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps/{slug}":{"get":{"operationId":"getApp","summary":"앱 자세히 보기 (Get app)","description":"slug로 앱 하나의 전체 정보(설명, 교과 매핑, 미디어, 버전, 큐레이터 추천, 랭킹)를 돌려줍니다.\nFull details of one app by slug. Hidden/archived apps are visible only to their owner.\n\nMCP tool: `get_app`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["apps"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"get_app","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"responses":{"200":{"description":"Get app","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateApp","summary":"앱 정보 수정 (Update app)","description":"본인 앱의 정보를 고칩니다. 보낸 필드만 바뀝니다. curriculum을 보내면 전체가 바뀝니다. new_slug로 주소를 바꿀 수 있고, status로 숨김(hidden) · 보관(archived)합니다.\nconfirm_own_work: true — 예전에 등록해서 본인 제작 확인(own_work_confirmed_at)이 없는 내 앱에 확인을 남깁니다. 반드시 선생님께 \"이 앱은 제가 직접 만든 앱이에요. 다른 사람이 만든 앱을 대신 등록하지 않아요.\" 문장을 보여 주고 직접 물어본 뒤, \"네\"라고 답했을 때만 보내세요. 스스로 판단하거나 추측하지 마세요. 앱 주인만 할 수 있습니다.\npurpose=education → curriculum 1–3행 필수, category 금지. purpose=general → category 필수 (classroom|automation|counseling|assessment|game|utility), curriculum 금지.\ncurriculum 행 = { level: elementary|middle, grades: 초등 1-2·3-4·5-6 / 중 1·2·3, subject, areas }. subject=creative-activities(창의적 체험활동)는 areas를 보내지 않습니다. 그 밖의 교과는 areas ≥1, 모두 그 학교급 · 교과의 영역 코드(list_curriculum).\nEducation apps need 1–3 curriculum rows and no category; general apps need a category and no curriculum. creative-activities has no areas.\nPartial update of your own app (scope apps:write). Classification is re-validated against the merged state.\n\nMCP tool: `update_app`\n\n인증 필요 — 토큰 scope `apps:write`. (Requires auth, scope apps:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["apps"],"security":[{"agentToken":["apps:write"]}],"x-mcp-tool":"update_app","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":40},"tagline":{"type":"string","maxLength":60},"description":{"type":"string","maxLength":5000},"url":{"type":"string","maxLength":500,"format":"uri"},"purpose":{"type":"string","enum":["education","general"]},"category":{"type":["string","null"]},"curriculum":{"type":["array","null"],"items":{"type":"object","properties":{"level":{"type":"string","minLength":1},"grades":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"}]}},"subject":{"type":"string","minLength":1},"areas":{"type":"array","items":{"type":"string"}}},"required":["level","subject"],"additionalProperties":false}},"new_slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"status":{"type":"string","enum":["published","hidden","archived"]},"stack":{"type":"array","items":{"type":"string","minLength":1,"maxLength":30},"maxItems":12},"built_with":{"type":["string","null"],"minLength":1,"maxLength":60},"version":{"type":"string"},"release_note":{"type":"string","maxLength":2000},"confirm_own_work":{"type":"boolean","description":"본인 제작 확인. 반드시 선생님께 \"이 앱은 제가 직접 만든 앱이에요. 다른 사람이 만든 앱을 대신 등록하지 않아요.\" 문장을 보여 주고 직접 물어본 뒤, 선생님이 분명히 \"네\"라고 답했을 때만 true로 보내세요. 에이전트가 스스로 판단하거나 추측해서 넣으면 안 됩니다. (Ask the teacher explicitly first; never set this on your own or infer it.)"},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Update app","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps/{slug}/media":{"post":{"operationId":"uploadMedia","summary":"아이콘 · 썸네일 · 스크린샷 올리기 (Upload media)","description":"앱 이미지를 올립니다. kind: icon(512×512 정사각) · thumbnail(1600×1000) · screenshot(최대 1600, 8장까지). theme: light|dark. WebP로 바뀝니다.\n이미지는 url(공개 주소에서 가져옴) 또는 data_base64 중 하나로 보냅니다. REST는 multipart/form-data의 file도 받습니다. 최대 10MB, png · jpeg · webp · gif · avif · svg.\nUpload an image (scope apps:write): `url` or `data_base64` (REST also accepts multipart `file`). icon 512², thumbnail 1600×1000.\n\nMCP tool: `upload_media`\n\n인증 필요 — 토큰 scope `apps:write`. (Requires auth, scope apps:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["apps"],"security":[{"agentToken":["apps:write"]}],"x-mcp-tool":"upload_media","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["icon","thumbnail","screenshot"]},"theme":{"type":"string","enum":["light","dark"],"default":"light"},"sort":{"type":"integer","minimum":0,"maximum":99},"data_base64":{"type":"string","maxLength":13981214},"content_type":{"type":"string","maxLength":60},"dry_run":{"type":"boolean"},"url":{"type":"string","maxLength":500,"format":"uri","description":"public image URL to fetch (instead of data_base64)"}},"required":["kind"],"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","required":["file","kind"],"properties":{"file":{"type":"string","format":"binary","description":"image file (png, jpeg, webp, gif, avif, svg)"},"kind":{"type":"string","enum":["icon","thumbnail","screenshot"]},"theme":{"type":"string","enum":["light","dark"],"default":"light"},"sort":{"type":"integer","minimum":0,"maximum":99},"dry_run":{"type":"boolean"}}}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Upload media","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps/{slug}/versions":{"post":{"operationId":"addVersion","summary":"새 버전 기록 (Add version)","description":"본인 앱에 새 버전(semver, 예: 1.2.0)과 바뀐 점(note)을 기록합니다. 같은 버전은 두 번 못 씁니다(VERSION_EXISTS).\nRecord a release (scope apps:write). version must be semver; duplicates → 409 VERSION_EXISTS.\n\nMCP tool: `add_version`\n\n인증 필요 — 토큰 scope `apps:write`. (Requires auth, scope apps:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["apps"],"security":[{"agentToken":["apps:write"]}],"x-mcp-tool":"add_version","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"note":{"type":"string","maxLength":2000,"default":""},"released_at":{"type":["string","null"],"format":"date-time"},"dry_run":{"type":"boolean"}},"required":["version"],"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Add version","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps/{slug}/hype":{"post":{"operationId":"hypeApp","summary":"하이프 보내기 (Hype app)","description":"앱에 하이프를 보냅니다. 사용자 · 앱마다 하루(Asia/Seoul) 5회, 본인 앱은 안 됩니다(OWN_APP). 가중치는 보낸 사람 등급: member 1, curator 3.\nHype an app (scope social:write). 5/day per app (Asia/Seoul), not your own app; curator weight 3. Over the limit → 429 HYPE_DAILY_LIMIT.\n\nMCP tool: `hype_app`\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["social"],"security":[{"agentToken":["social:write"]}],"x-mcp-tool":"hype_app","parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Hype app","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/apps/{slug}/recommend":{"put":{"operationId":"recommendApp","summary":"추천하기 (Recommend app)","description":"앱을 추천(또는 취소)합니다. 사람마다 앱 하나에 한 번, 본인 앱은 안 됩니다. 큐레이터는 note(한 줄 평, ≤100자)를 붙일 수 있고 가중치 3입니다. 일반 회원이 note를 보내면 NOTE_CURATOR_ONLY.\nRecommend an app (scope social:write). Curators may add a one-line note and weigh 3×.\nREST PUT은 추천을 켭니다(recommend 기본 true, note 수정 가능). MCP의 recommend 생략 = 토글, true = 켜기, false = 끄기.\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["social"],"security":[{"agentToken":["social:write"]}],"parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recommend":{"type":"boolean"},"note":{"type":["string","null"],"maxLength":100},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Recommend app","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"unrecommendApp","summary":"추천 취소 (Remove recommendation)","description":"내 추천을 지웁니다. (Remove your recommendation; scope social:write.)\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["social"],"security":[{"agentToken":["social:write"]}],"parameters":[{"schema":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"required":true,"name":"slug","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Remove recommendation","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/rankings":{"get":{"operationId":"getRankings","summary":"랭킹 보기 (Get rankings)","description":"period: live(최근 60분 하이프 가중치 합, 기본) · weekly(월–일 Asia/Seoul: 하이프 + 5×추천 + 3×댓글 단 사람 수) · all(누적 하이프). delta는 1분 전 대비 순위 변동(▲ 양수).\nweekly는 week=2026-W47 처럼 지난 주도 볼 수 있습니다. purpose, level로 거를 수 있습니다.\nRankings: live (60-min hype), weekly (hype + 5×recommend + 3×distinct commenters), all (all-time hype).\n\nMCP tool: `get_rankings`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["social"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"get_rankings","parameters":[{"schema":{"type":"string","enum":["live","weekly","all"],"default":"live"},"required":false,"name":"period","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-W\\d{2}$"},"required":false,"name":"week","in":"query"},{"schema":{"type":"string","enum":["education","general"]},"required":false,"name":"purpose","in":"query"},{"schema":{"type":"string"},"required":false,"name":"level","in":"query"}],"responses":{"200":{"description":"Get rankings","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/curators":{"get":{"operationId":"listCurators","summary":"큐레이터 목록 (List curators)","description":"틸더스 큐레이터(관리자가 지정한 등급)와 최근 추천(picks, 한 줄 평 포함)을 돌려줍니다. 큐레이터의 하이프 · 추천 가중치는 3입니다.\nCurators (admin-appointed) and their recent picks with notes.\n\nMCP tool: `list_curators`\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["social"],"security":[{},{"agentToken":[]}],"x-mcp-tool":"list_curators","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"maximum":20,"default":3},"required":false,"name":"picks","in":"query"}],"responses":{"200":{"description":"List curators","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/comments":{"get":{"operationId":"listComments","summary":"댓글 보기 (List comments)","description":"target_type(app|post)과 target_id(앱 slug · id 또는 글 id)의 댓글 트리를 돌려줍니다. (Comment tree of an app or post.)\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["community"],"security":[{},{"agentToken":[]}],"parameters":[{"schema":{"type":"string","enum":["app","post"]},"required":true,"name":"target_type","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":64},"required":true,"name":"target_id","in":"query"}],"responses":{"200":{"description":"List comments","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"postComment","summary":"댓글 쓰기 (Post comment)","description":"앱(target_type=app, target_id=slug) 또는 게시글(target_type=post, target_id=uuid)에 댓글을 씁니다. parent_id로 답글(깊이 최대 4). 본문 ≤2000자. 에이전트가 쓴 댓글에는 에이전트 이름이 표시됩니다.\nComment on an app or post (scope social:write). Replies via parent_id, max depth 4.\n\nMCP tool: `post_comment`\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["community"],"security":[{"agentToken":["social:write"]}],"x-mcp-tool":"post_comment","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_type":{"type":"string","enum":["app","post"]},"target_id":{"type":"string","minLength":1,"maxLength":64},"parent_id":{"type":["string","null"],"format":"uuid"},"body":{"type":"string","minLength":1,"maxLength":2000},"dry_run":{"type":"boolean"}},"required":["target_type","target_id","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Post comment","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/posts":{"get":{"operationId":"listPosts","summary":"게시글 목록 (List posts)","description":"게시판 글 목록. channel(showcase|prompt|deploy|class|qna|free), sort(hot|new|rising|top), author(handle). (Board posts.)\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["community"],"security":[{},{"agentToken":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","enum":["showcase","prompt","deploy","class","qna","free"]},"required":false,"name":"channel","in":"query"},{"schema":{"type":"string","enum":["hot","new","rising","top"],"default":"hot"},"required":false,"name":"sort","in":"query"},{"schema":{"type":"string","maxLength":32},"required":false,"name":"author","in":"query"}],"responses":{"200":{"description":"List posts","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createPost","summary":"게시글 쓰기 (Create post)","description":"게시판에 글을 씁니다. channel: showcase(자랑) · prompt(프롬프트) · deploy(배포) · class(수업) · qna(질문) · free(자유). 제목 ≤120자, 본문 마크다운. app_slug로 관련 앱을 붙일 수 있습니다.\nCreate a board post (scope social:write).\n\nMCP tool: `create_post`\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["community"],"security":[{"agentToken":["social:write"]}],"x-mcp-tool":"create_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"channel":{"type":"string","enum":["showcase","prompt","deploy","class","qna","free"]},"title":{"type":"string","minLength":1,"maxLength":120},"body":{"type":"string","maxLength":20000,"default":""},"app_slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"dry_run":{"type":"boolean"}},"required":["channel","title"],"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Create post","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/posts/{id}":{"get":{"operationId":"getPost","summary":"게시글 보기 (Get post)","description":"게시글 하나와 댓글. (One post with its comments.)\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["community"],"security":[{},{"agentToken":[]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get post","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/votes":{"post":{"operationId":"vote","summary":"추천 · 비추천 투표 (Vote)","description":"게시글 또는 댓글에 투표합니다. value: 1(추천) · -1(비추천) · 0(투표 취소). 대상마다 한 표.\nVote on a post or comment (scope social:write). value 1 | -1 | 0 (remove).\n\nMCP tool: `vote`\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["community"],"security":[{"agentToken":["social:write"]}],"x-mcp-tool":"vote","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_type":{"type":"string","enum":["post","comment"]},"target_id":{"type":"string","format":"uuid"},"value":{"anyOf":[{"type":"number","enum":[1]},{"type":"number","enum":[-1]},{"type":"number","enum":[0]}]},"dry_run":{"type":"boolean"}},"required":["target_type","target_id","value"],"additionalProperties":false}}}},"responses":{"200":{"description":"Vote","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/users/{handle}":{"get":{"operationId":"getUser","summary":"사용자 프로필 (Get user)","description":"handle로 공개 프로필과 그 사람의 앱을 돌려줍니다. followers_count(팔로워 수)와 following(내가 팔로우 중인지, 익명이면 false)을 함께 줍니다. (Public profile and apps by handle, with followers_count and the caller's following flag.)\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["profile"],"security":[{},{"agentToken":[]}],"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":32},"required":true,"name":"handle","in":"path"}],"responses":{"200":{"description":"Get user","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/users/{handle}/follow":{"put":{"operationId":"followUser","summary":"팔로우 (Follow user)","description":"다른 선생님을 팔로우합니다. 자기 자신은 안 됩니다(SELF_FOLLOW). 이미 팔로우 중이면 그대로 성공합니다(멱등). follow: false로 보내면 팔로우를 끊습니다.\nFollow a teacher by handle (scope social:write). Idempotent; you cannot follow yourself. follow=false unfollows.\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["profile"],"security":[{"agentToken":["social:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])$"},"required":true,"name":"handle","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Follow user","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"unfollowUser","summary":"팔로우 끊기 (Unfollow user)","description":"팔로우를 끊습니다. 팔로우하지 않았어도 성공합니다(멱등). (Unfollow; idempotent, scope social:write.)\n\n인증 필요 — 토큰 scope `social:write`. (Requires auth, scope social:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["profile"],"security":[{"agentToken":["social:write"]}],"parameters":[{"schema":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])$"},"required":true,"name":"handle","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Unfollow user","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me":{"get":{"operationId":"getMyProfile","summary":"내 프로필 (Get my profile)","description":"토큰 주인의 프로필(닉네임, handle, 등급, bio, role_label, links, avatar_url · avatar_seed · avatar_kind)을 돌려줍니다.\navatar_url은 올린 사진이 있으면 그 사진, 없으면 DiceBear Critters 기본 아바타(/avatars/<avatar_seed>.svg)입니다.\nThe token owner's profile (scope profile:read). avatar_url = uploaded photo, else the Critters avatar of avatar_seed.\n\nMCP tool: `get_my_profile`\n\n인증 필요 — 토큰 scope `profile:read`. (Requires auth, scope profile:read.)","tags":["profile"],"security":[{"agentToken":["profile:read"]}],"x-mcp-tool":"get_my_profile","responses":{"200":{"description":"Get my profile","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateProfile","summary":"내 프로필 수정 (Update my profile)","description":"nickname(2–16자, 글자 · 숫자 · 공백 · _ . -, 겹치거나 예약된 이름이면 NICKNAME_TAKEN), bio(≤300자), role_label(예: \"초등 · 6학년 담임\", ≤40자), links(최대 8개, kind=github|threads|instagram|youtube|x|blog|website — 보내면 목록 전체가 바뀝니다)를 고칩니다. 학교 · 실명 · 학생 정보는 넣지 마세요.\navatar: \"random\"(새 Critters 아바타 뽑기) · \"default\"(올린 사진 지우고 기본 아바타로) · 시드 문자열(영문 · 숫자 · _ -, 그 시드의 Critters) — 어느 것이든 올린 사진은 지워집니다. 사진 올리기는 REST POST /me/avatar.\nUpdate your profile (scope profile:write). links replaces the whole list. avatar: \"random\" | \"default\" | <seed> (clears any uploaded photo).\n\nMCP tool: `update_profile`\n\n인증 필요 — 토큰 scope `profile:write`. (Requires auth, scope profile:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["profile"],"security":[{"agentToken":["profile:write"]}],"x-mcp-tool":"update_profile","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"nickname":{"type":"string","minLength":2,"maxLength":16,"pattern":"^[\\p{L}\\p{N}_.\\- ]+$/u"},"handle":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])$"},"bio":{"type":["string","null"],"maxLength":300},"role_label":{"type":["string","null"],"maxLength":40},"avatar_url":{"type":["string","null"],"maxLength":500,"format":"uri"},"avatar":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{0,63}$/i"},"links":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["github","threads","instagram","youtube","x","blog","website"]},"url":{"type":"string","maxLength":500,"format":"uri"}},"required":["kind","url"],"additionalProperties":false},"maxItems":8},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Update my profile","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteAccount","summary":"회원 탈퇴 (Delete my account)","description":"회원 탈퇴. 웹 브라우저 세션 전용입니다 — 에이전트 토큰은 403 FORBIDDEN. 본문 { confirm_nickname: 정확한 닉네임 }.\n내 앱(교과 · 버전 · 이미지 포함) · 하이프 · 추천 · 투표 · 팔로우 · 런치패드 · 토큰 · 세션이 지워지고, 글과 댓글은 '탈퇴한 선생님'의 글로 익명 처리됩니다. 마지막 관리자는 탈퇴할 수 없습니다(409 LAST_ADMIN).\nDelete the signed-in account (browser session only; agent tokens get 403). Posts/comments are anonymised, everything else is removed; the session cookie is cleared.\n\n인증 필요. (Requires auth.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["profile"],"security":[{"agentToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"confirm_nickname":{"type":"string","maxLength":64},"dry_run":{"type":"boolean"}},"required":["confirm_nickname"],"additionalProperties":false}}}},"responses":{"200":{"description":"Delete my account","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/avatar":{"post":{"operationId":"uploadAvatar","summary":"프로필 사진 올리기 (Upload profile photo)","description":"프로필 사진을 올립니다. JPEG · PNG · WebP, 최대 5MB → 256×256 WebP. multipart/form-data의 file 또는 JSON data_base64. 예전 사진은 지워집니다. 기본 아바타로 돌아가려면 PATCH /me { \"avatar\": \"default\" }.\nUpload a profile photo (scope profile:write): multipart `file` or JSON `data_base64`; JPEG/PNG/WebP ≤ 5 MB, stored as 256×256 WebP.\n\n인증 필요 — 토큰 scope `profile:write`. (Requires auth, scope profile:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["profile"],"security":[{"agentToken":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data_base64":{"type":"string","maxLength":6990707},"content_type":{"type":"string","maxLength":60},"dry_run":{"type":"boolean"}},"additionalProperties":false}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"photo (jpeg, png, webp; ≤ 5 MB) → 256×256 WebP"},"dry_run":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Upload profile photo","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/notifications":{"get":{"operationId":"listNotifications","summary":"내 알림 (List my notifications)","description":"내 앱 · 글 · 댓글에 달린 반응 알림을 최근 활동 순으로 돌려줍니다: app_comment(내 앱에 댓글) · post_comment(내 글에 댓글) · comment_reply(내 댓글에 답글) · app_hype(내 앱 하이프, 앱 · 날짜(한국 시간)마다 한 줄로 모아 count) · app_recommend · curator_pick(큐레이터 추천, note = 한 줄 평) · follow(새 팔로워).\n각 항목에 text(한국어 한 문장), url, read, actor(탈퇴한 사람은 \"탈퇴한 선생님\")가 있습니다. unread: true(REST unread=1)면 안 읽은 것만, 다음 쪽은 next_cursor를 cursor로. unread_count도 함께 옵니다.\nList the caller's notifications, newest activity first (scope profile:read). unread=1 filters; paginate with cursor = next_cursor.\n\nMCP tool: `list_notifications`\n\n인증 필요 — 토큰 scope `profile:read`. (Requires auth, scope profile:read.)","tags":["notifications"],"security":[{"agentToken":["profile:read"]}],"x-mcp-tool":"list_notifications","parameters":[{"schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["0","1","true","false",""]}],"description":"true (REST: unread=1) → 안 읽은 알림만 (only unread)"},"required":false,"description":"true (REST: unread=1) → 안 읽은 알림만 (only unread)","name":"unread","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":200},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"List my notifications","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/notifications/unread-count":{"get":{"operationId":"countUnreadNotifications","summary":"안 읽은 알림 수 (Unread notification count)","description":"안 읽은 알림 수 { unread_count }. 웹의 알림 종 배지가 씁니다. (Unread count; scope profile:read.)\n\n인증 필요 — 토큰 scope `profile:read`. (Requires auth, scope profile:read.)","tags":["notifications"],"security":[{"agentToken":["profile:read"]}],"responses":{"200":{"description":"Unread notification count","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/notifications/read":{"post":{"operationId":"markNotificationsRead","summary":"알림 읽음 표시 (Mark notifications read)","description":"알림을 읽음으로 표시합니다. { ids: [알림 id …] }(최대 100개, 내 알림만) 또는 { all: true }(전부). 선생님이 읽었다고 할 때만 쓰세요.\nMark notifications read (scope profile:write): { ids } or { all: true }. Returns updated and the new unread_count.\n\nMCP tool: `mark_notifications_read`\n\n인증 필요 — 토큰 scope `profile:write`. (Requires auth, scope profile:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["notifications"],"security":[{"agentToken":["profile:write"]}],"x-mcp-tool":"mark_notifications_read","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":100},"all":{"type":"boolean","enum":[true]},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Mark notifications read","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads":{"get":{"operationId":"listLaunchpads","summary":"내 런치패드 목록 (List my launchpads)","description":"런치패드: 학급마다 하나씩(한 사람당 5개) 만드는 학생용 앱 모음입니다. 학생은 로그인 없이 학생 링크(https://tuilders.com/l/<code>)로 들어와 선생님이 담은 앱만 엽니다. 학생 정보는 받지도 저장하지도 않습니다.\nLaunchpads: per-class pages of teacher-approved app links. Students open the link without logging in and can only launch the deployed apps; no student data is collected.\n내 런치패드와 담긴 앱(item id · 제목 · 주소 · 실행 수), 학생 링크(link)를 돌려줍니다. 런치패드를 고치려면 여기서 id를 얻으세요.\nYour launchpads with their items and student links (scope launchpad:write).\n\nMCP tool: `list_launchpads`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"list_launchpads","responses":{"200":{"description":"List my launchpads","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createLaunchpad","summary":"런치패드 만들기 (Create launchpad)","description":"런치패드: 학급마다 하나씩(한 사람당 5개) 만드는 학생용 앱 모음입니다. 학생은 로그인 없이 학생 링크(https://tuilders.com/l/<code>)로 들어와 선생님이 담은 앱만 엽니다. 학생 정보는 받지도 저장하지도 않습니다.\nLaunchpads: per-class pages of teacher-approved app links. Students open the link without logging in and can only launch the deployed apps; no student data is collected.\n새 런치패드를 만듭니다. name(≤30자, 예: \"6학년 2반\" — 학생 이름은 넣지 마세요), theme(lavender|sky|mint|sun|pink|lime|coral, 기본 lavender). 한 사람당 5개까지(넘으면 409 LAUNCHPAD_LIMIT).\n결과의 launchpad.link가 학생에게 줄 링크입니다. 다음: add_launchpad_item으로 앱을 담으세요.\nCreate a launchpad (scope launchpad:write, max 5). Share launchpad.link with students, then add apps with add_launchpad_item.\n\nMCP tool: `create_launchpad`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"create_launchpad","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"학급 · 모둠 이름, ≤30자 (예: \"6학년 2반\"). 학생 이름은 넣지 마세요."},"theme":{"type":"string","enum":["lavender","sky","mint","sun","pink","lime","coral"],"description":"색 테마 (기본 lavender)"},"dry_run":{"type":"boolean"}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Create launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/{id}":{"get":{"operationId":"getLaunchpad","summary":"런치패드 하나 보기 (Get launchpad)","description":"내 런치패드 하나(담긴 앱 포함). 관리자는 다른 사람 것도 읽을 수 있습니다. (One of your launchpads; admins may read any.)\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Get launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"updateLaunchpad","summary":"런치패드 수정 · 쉬게 하기 (Update launchpad)","description":"name(≤30자), theme(lavender|sky|mint|sun|pink|lime|coral), is_active를 바꿉니다. is_active: false면 쉬는 중 — 학생 화면에 앱이 안 보이고 열리지도 않습니다. true로 다시 엽니다.\nRename, re-theme or pause (is_active=false) / resume a launchpad (scope launchpad:write).\n\nMCP tool: `update_launchpad`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"update_launchpad","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id"},"required":true,"description":"launchpad id","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"theme":{"type":"string","enum":["lavender","sky","mint","sun","pink","lime","coral"]},"is_active":{"type":"boolean","description":"false = 쉬게 하기(학생 화면에 앱이 안 보이고 열 수 없음), true = 다시 열기"},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Update launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"deleteLaunchpad","summary":"런치패드 지우기 (Delete launchpad)","description":"런치패드와 담긴 앱 목록을 지웁니다. 학생 링크도 바로 막힙니다. 되돌릴 수 없으니 먼저 dry_run으로 확인하세요.\nDelete a launchpad and its items; the student link dies (scope launchpad:write). Irreversible.\n\nMCP tool: `delete_launchpad`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"delete_launchpad","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id (list_launchpads)"},"required":true,"description":"launchpad id (list_launchpads)","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Delete launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/{id}/rotate":{"post":{"operationId":"rotateLaunchpadLink","summary":"학생 링크 새로 만들기 (Rotate student link)","description":"학생 링크(코드)를 새로 만듭니다. 예전 링크는 바로 막힙니다 — 링크가 반 밖으로 퍼졌을 때 쓰세요. 새 link를 학생들에게 다시 알려 주세요.\nIssue a new student link; the old one stops working immediately (scope launchpad:write).\n\nMCP tool: `rotate_launchpad_link`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"rotate_launchpad_link","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id (list_launchpads)"},"required":true,"description":"launchpad id (list_launchpads)","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Rotate student link","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/{id}/items":{"post":{"operationId":"addLaunchpadItem","summary":"런치패드에 앱 담기 (Add app to launchpad)","description":"런치패드에 앱을 담습니다(배포). 둘 중 하나: app_slug(아카이브 앱 — 그 앱의 주소 · 제목 · 아이콘) 또는 url + title(아카이브 밖 주소).\nurl은 http(s)만, 아이디 · 비밀번호가 든 주소 · javascript: · data: 는 안 됩니다(≤2048자). 아카이브 앱 주소와 같으면(끝 / · 쿼리 순서 무시) 그 앱에 연결되고 title을 생략할 수 있습니다. title ≤40자.\n런치패드 하나에 30개까지(LAUNCHPAD_ITEMS_LIMIT), 같은 주소는 한 번만(409 DUPLICATE_ITEM). 수업에 맞는 앱은 find_apps_for_lesson · search_apps로 찾으세요.\n어느 런치패드: id 또는 launchpad(id · 코드 · 이름, 예: \"3학년 2반\" — 대소문자 · 띄어쓰기 무시). 런치패드가 하나면 둘 다 생략. 여러 개인데 정하지 않으면 409 LAUNCHPAD_AMBIGUOUS(allowed = [{id,name,code}]) → 선생님께 어느 반인지 물어보세요. 하나도 없으면 409 NO_LAUNCHPAD → create_launchpad.\nposition: \"last\"(기본, 맨 뒤) | \"first\"(맨 앞 — 이미 담긴 앱이면 오류 대신 맨 앞으로 옮김).\nDeploy an app onto a launchpad (scope launchpad:write): { app_slug } or { url, title }. Pick the pad by id or `launchpad` (id/code/name; optional with one pad). position first|last. http(s) only; max 30 items; duplicate URL → 409 DUPLICATE_ITEM unless position=first (moves it).\n\nMCP tool: `add_launchpad_item`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"add_launchpad_item","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id (REST path). MCP: launchpad 셀렉터를 써도 됩니다"},"required":false,"description":"launchpad id (REST path). MCP: launchpad 셀렉터를 써도 됩니다","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"launchpad":{"type":"string","minLength":1,"maxLength":50,"description":"런치패드 id · 코드 · 이름(예: \"3학년 2반\"). 런치패드가 하나뿐이면 생략"},"position":{"type":"string","enum":["first","last"],"default":"last","description":"first = 맨 앞(이미 담긴 앱이면 맨 앞으로 옮김), last = 맨 뒤(기본)"},"app_slug":{"type":"string","minLength":3,"maxLength":64,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"아카이브 앱 slug — 그 앱의 url · 제목 · 아이콘을 씁니다"},"url":{"type":"string","maxLength":2112,"description":"http(s) 주소 (≤2048자). 아카이브 앱 주소와 같으면 그 앱에 연결됩니다"},"title":{"type":"string","description":"학생에게 보일 이름 ≤40자 (url만 보낼 때는 필수)"},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"dry_run preview (nothing written) — `dry_run: true`","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"201":{"description":"Add app to launchpad","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/{id}/items/{item_id}":{"patch":{"operationId":"updateLaunchpadItem","summary":"담긴 앱 이름 · 위치 바꾸기 (Update launchpad item)","description":"title(≤40자)과 sort(새 위치, 0부터 — 나머지는 밀립니다)를 바꿉니다.\nRename an item or move it to position `sort` (0-based) (scope launchpad:write).\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id"},"required":true,"description":"launchpad id","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"item_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"sort":{"type":["integer","null"],"minimum":0,"maximum":29,"description":"새 위치 (0부터)"},"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Update launchpad item","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"removeLaunchpadItem","summary":"담긴 앱 빼기 (Remove launchpad item)","description":"런치패드에서 앱 하나를 뺍니다. 학생 화면에서 바로 사라지고 그 실행 링크도 막힙니다. item_id는 list_launchpads에서.\nRemove one item; it disappears from the student page and its launch link stops working (scope launchpad:write).\n\nMCP tool: `remove_launchpad_item`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"remove_launchpad_item","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id"},"required":true,"description":"launchpad id","name":"id","in":"path"},{"schema":{"type":"string","format":"uuid"},"required":true,"name":"item_id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dry_run":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Remove launchpad item","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/launchpads/{id}/items/order":{"put":{"operationId":"reorderLaunchpadItems","summary":"담긴 앱 순서 바꾸기 (Reorder launchpad items)","description":"item_ids 순서대로 앞에 놓고, 목록에 없는 앱은 원래 순서대로 그 뒤에 둡니다. 학생 화면도 이 순서입니다.\nPut the listed items first, in that order; the rest follow in their current order (scope launchpad:write).\n\nMCP tool: `reorder_launchpad_items`\n\n인증 필요 — 토큰 scope `launchpad:write`. (Requires auth, scope launchpad:write.)\n\n`dry_run: true` (본문) 또는 `?dry_run=true` 이면 저장 없이 검증하고 결과를 미리 돌려줍니다. (dry_run validates and previews without writing.)","tags":["launchpads"],"security":[{"agentToken":["launchpad:write"]}],"x-mcp-tool":"reorder_launchpad_items","parameters":[{"schema":{"type":"string","format":"uuid","description":"launchpad id"},"required":true,"description":"launchpad id","name":"id","in":"path"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"item_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":30,"description":"새 순서의 item id 목록"},"dry_run":{"type":"boolean"}},"required":["item_ids"],"additionalProperties":false}}}},"responses":{"200":{"description":"Reorder launchpad items","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"인증 필요 또는 토큰 무효 (UNAUTHORIZED / TOKEN_INVALID).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"권한 · 스코프 부족 (INSUFFICIENT_SCOPE, FORBIDDEN, OWN_APP, NOTE_CURATOR_ONLY, ONBOARDING_REQUIRED).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"충돌 (SLUG_TAKEN, VERSION_EXISTS, Idempotency-Key 재사용 …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/launchpads/{code}":{"get":{"operationId":"getPublicLaunchpad","summary":"학생용 런치패드 (Public launchpad (student view))","description":"학생 링크 /l/{code} 화면의 내용: 이름 · 테마 · 선생님 닉네임 · 담긴 앱(제목 · 아이콘 · launch_url). 쉬는 중이면 paused: true, items는 비어 있습니다. 앱은 launch_url(/l/{code}/go/{item_id})로 엽니다.\nIP · 코드마다 분당 120회로 제한합니다. 학생 정보는 받지 않습니다.\nWhat the student page shows (no auth, rate-limited per IP + code). Launch items through launch_url.\n\n인증 없이 호출할 수 있습니다. (No auth required.)","tags":["launchpads"],"security":[{},{"agentToken":[]}],"parameters":[{"schema":{"type":"string","maxLength":32},"required":true,"name":"code","in":"path"}],"responses":{"200":{"description":"Public launchpad (student view)","content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":{}}}}},"400":{"description":"검증 실패 — `field`와 `allowed`를 보고 고쳐서 다시 보내세요. (Validation failed; fix using `field`/`allowed`.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"대상 없음 (NOT_FOUND, APP_NOT_FOUND, …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청 제한 또는 하이프 하루 한도 — `Retry-After` 헤더(초)를 지키세요. (Rate limited; honor Retry-After.)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{}}