{"components":{"securitySchemes":{"AdminKeyAuth":{"in":"header","name":"X-ADMIN-API-KEY","type":"apiKey"},"ApiKeyAuth":{"in":"header","name":"X-API-KEY","type":"apiKey"},"BearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"AI \uc5d0\uc774\uc804\ud2b8\uc6a9 \uc2a4\ud0ac \ub9c8\ucf13\ud50c\ub808\uc774\uc2a4 REST API.\n\n**\uc778\uc99d**\n- \uc2a4\ud0ac \uc5c5\ub85c\ub4dc/\uc218\uc815: `X-API-KEY` \ud5e4\ub354 \ub610\ub294 `Authorization: Bearer <api_key>`\n- \uad00\ub9ac\uc790 \uae30\ub2a5: `X-ADMIN-API-KEY` \ud5e4\ub354\n- \uc870\ud68c/\ub2e4\uc6b4\ub85c\ub4dc: \uc778\uc99d \ubd88\ud544\uc694","title":"AI Skill Store API","version":"1.0.0"},"openapi":"3.0.0","paths":{"/v1/admin/owners":{"get":{"responses":{"200":{"description":"\uc0ac\uc6a9\uc790 \ubaa9\ub85d"},"401":{"description":"\uad8c\ud55c \uc5c6\uc74c"}},"security":[{"AdminKeyAuth":[]}],"summary":"\uc804\uccb4 \uc0ac\uc6a9\uc790 \ubaa9\ub85d \uc870\ud68c","tags":["admin"]}},"/v1/admin/owners/{owner_id}/active":{"post":{"parameters":[{"in":"path","name":"owner_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"is_active":{"type":"boolean"}},"type":"object"}}}},"responses":{"200":{"description":"\ucc98\ub9ac \uc644\ub8cc"}},"security":[{"AdminKeyAuth":[]}],"summary":"\uc0ac\uc6a9\uc790 \ud65c\uc131/\ube44\ud65c\uc131 \uc124\uc815","tags":["admin"]}},"/v1/agent/info":{"get":{"description":"\uc9c0\uc6d0 \ud50c\ub7ab\ud3fc, trust \ub808\ubca8, \uc5d4\ub4dc\ud3ec\uc778\ud2b8 \ubaa9\ub85d, SDK \uc815\ubcf4 \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","responses":{"200":{"description":"\uc11c\ube44\uc2a4 \uc815\ubcf4 JSON"}},"summary":"\uc11c\ube44\uc2a4 \uba54\ud0c0\ub370\uc774\ud130 (\uc5d0\uc774\uc804\ud2b8 \uc9c4\uc785\uc810)","tags":["agent"]}},"/v1/agent/search":{"get":{"description":"\uc5d0\uc774\uc804\ud2b8\uac00 \ud544\uc694\ud55c \uae30\ub2a5(capability)\uc744 \uac80\uc0c9. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"description":"\ucc3e\uc73c\ub824\ub294 \uae30\ub2a5 (\uc608: web_search, hash_generation)","in":"query","name":"capability","schema":{"type":"string"}},{"description":"\ud0a4\uc6cc\ub4dc \uac80\uc0c9 (\uc774\ub984/\uc124\uba85)","in":"query","name":"q","schema":{"type":"string"}},{"description":"\ud50c\ub7ab\ud3fc \ud544\ud130","in":"query","name":"platform","schema":{"enum":["OpenClaw","ClaudeCode","CustomAgent"],"type":"string"}},{"description":"USK v3 \uc804\uc6a9 \ud544\ud130","in":"query","name":"usk_v3","schema":{"type":"boolean"}},{"description":"\uc815\ud655\ud55c trust \ub808\ubca8","in":"query","name":"trust","schema":{"enum":["verified","community","sandbox"],"type":"string"}},{"description":"\ucd5c\uc18c trust \ub808\ubca8 (\uacc4\uce35 \uc801\uc6a9)","in":"query","name":"min_trust","schema":{"enum":["verified","community","sandbox"],"type":"string"}},{"in":"query","name":"limit","schema":{"default":20,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"\ub9e4\uce6d \uc2a4\ud0ac \ubaa9\ub85d (capabilities, schema \ud3ec\ud568)"}},"summary":"capability \uae30\ubc18 \uc2a4\ud0ac \uac80\uc0c9","tags":["agent"]}},"/v1/agent/skills/{skill_id}/download":{"get":{"description":"platform \ud30c\ub77c\ubbf8\ud130\uc5d0 \ub530\ub77c \uc801\ud569\ud55c .skill \ud30c\uc77c \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"platform","schema":{"default":"OpenClaw","enum":["OpenClaw","ClaudeCode","CustomAgent"],"type":"string"}}],"responses":{"200":{"description":".skill \ud30c\uc77c (ZIP)"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\ud50c\ub7ab\ud3fc\ubcc4 \uc2a4\ud0ac \ud328\ud0a4\uc9c0 \ub2e4\uc6b4\ub85c\ub4dc","tags":["agent"]}},"/v1/agent/skills/{skill_id}/schema":{"get":{"description":"input/output schema, capabilities, permissions, \ub2e4\uc6b4\ub85c\ub4dc URL \ubc18\ud658. \uc778\uc99d \ubd88\ud544\uc694.","parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\uc2a4\ud0ac \uc2a4\ud0a4\ub9c8 (interface, input_schema, output_schema, capabilities)"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \uc804\uccb4 \uc2a4\ud0a4\ub9c8 \uc870\ud68c","tags":["agent"]}},"/v1/analytics/events":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"event_type":{"enum":["install","run","error","uninstall","view"],"type":"string"},"platform":{"type":"string"},"skill_id":{"type":"string"}},"required":["skill_id","event_type"],"type":"object"}}}},"responses":{"200":{"description":"\uae30\ub85d \uc644\ub8cc"}},"summary":"\uc2a4\ud0ac \uc0ac\uc6a9 \uc774\ubca4\ud2b8 \uae30\ub85d","tags":["analytics"]}},"/v1/owners/register":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"email":{"type":"string"},"username":{"type":"string"}},"required":["username"],"type":"object"}}}},"responses":{"201":{"description":"\ub4f1\ub85d \uc131\uacf5, api_key \ubc18\ud658"},"409":{"description":"\uc911\ubcf5"}},"summary":"\uac1c\ubc1c\uc790 \uacc4\uc815 \ub4f1\ub85d (API \ud0a4 \ubc1c\uae09)","tags":["owners"]}},"/v1/platforms":{"get":{"responses":{"200":{"description":"\ud50c\ub7ab\ud3fc \ubaa9\ub85d"}},"summary":"\uc9c0\uc6d0 \ud50c\ub7ab\ud3fc \ubaa9\ub85d","tags":["platforms"]}},"/v1/skills":{"get":{"parameters":[{"description":"\uac80\uc0c9 \ud0a4\uc6cc\ub4dc","in":"query","name":"query","schema":{"type":"string"}},{"in":"query","name":"category","schema":{"type":"string"}},{"in":"query","name":"sort","schema":{"default":"newest","enum":["newest","downloads","rating"],"type":"string"}},{"in":"query","name":"min_rating","schema":{"default":0.0,"type":"number"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"description":"\uc2a4\ud0ac \ubaa9\ub85d (\ud398\uc774\uc9c0\ub124\uc774\uc158 \ud3ec\ud568)"}},"summary":"\uc2a4\ud0ac \ubaa9\ub85d \uc870\ud68c / \uac80\uc0c9","tags":["skills"]}},"/v1/skills/upload":{"post":{"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"owner_username":{"type":"string"},"skill_file":{"format":"binary","type":"string"}},"required":["skill_file","owner_username"],"type":"object"}}}},"responses":{"200":{"description":"\uc5c5\ub85c\ub4dc \uc131\uacf5, \ubcf4\uc548 \uc2ec\uc0ac \uc2dc\uc791"},"401":{"description":"\uc778\uc99d \uc2e4\ud328"}},"security":[{"ApiKeyAuth":[]}],"summary":"\uc2a4\ud0ac \uc5c5\ub85c\ub4dc","tags":["skills"]}},"/v1/skills/{skill_id}":{"delete":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\uc0ad\uc81c \uc131\uacf5"},"401":{"description":"\uad8c\ud55c \uc5c6\uc74c"}},"security":[{"ApiKeyAuth":[]},{"AdminKeyAuth":[]}],"summary":"\uc2a4\ud0ac \uc0ad\uc81c (\uc18c\uc720\uc790 \ub610\ub294 \uad00\ub9ac\uc790)","tags":["skills"]},"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"\uc2a4\ud0ac \uc0c1\uc138"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \uc0c1\uc138 \uc870\ud68c","tags":["skills"]}},"/v1/skills/{skill_id}/download":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":".skill \ud30c\uc77c"},"404":{"description":"\uc5c6\uc74c"}},"summary":"\uc2a4\ud0ac \ud30c\uc77c \ub2e4\uc6b4\ub85c\ub4dc","tags":["skills"]}},"/v1/skills/{skill_id}/install-guide":{"get":{"parameters":[{"in":"path","name":"skill_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"platform","schema":{"default":"OpenClaw","enum":["OpenClaw","ClaudeCode","CustomAgent"],"type":"string"}}],"responses":{"200":{"description":"\uc124\uce58 \ub2e8\uacc4 \ubaa9\ub85d"}},"summary":"\ud50c\ub7ab\ud3fc\ubcc4 \uc124\uce58 \uac00\uc774\ub4dc","tags":["platforms"]}}},"tags":[{"description":"AI \uc5d0\uc774\uc804\ud2b8 \uc804\uc6a9 \u2014 \uc778\uc99d \ubd88\ud544\uc694, capability \uae30\ubc18 \uac80\uc0c9 \ubc0f \uc2a4\ud0ac \ub2e4\uc6b4\ub85c\ub4dc","name":"agent"},{"description":"\uc2a4\ud0ac \uc870\ud68c/\uc5c5\ub85c\ub4dc/\ub2e4\uc6b4\ub85c\ub4dc","name":"skills"},{"description":"\uac1c\ubc1c\uc790 \uacc4\uc815 \uad00\ub9ac","name":"owners"},{"description":"Analytics \uc774\ubca4\ud2b8 \ubc0f \ud1b5\uacc4","name":"analytics"},{"description":"\ud50c\ub7ab\ud3fc \ubc0f \uc124\uce58 \uac00\uc774\ub4dc","name":"platforms"},{"description":"\uad00\ub9ac\uc790 \uc804\uc6a9","name":"admin"}]}