Skip to content

docs(safari): drop skill/download from public API (reclassified jwt, console-only) #106

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ysyneu merged 1 commit into from
Jun 24, 2026
Merged

docs(safari): drop skill/download from public API (reclassified jwt, console-only) #106

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 0 additions & 81 deletions api-reference/openapi.en.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20864,74 +20864,6 @@
}
}
},
"/safari/skill/download": {
"post": {
"operationId": "skill-read-download",
"summary": "Download skill",
"description": "Download a skill's zip archive by ID.",
"tags": [
"AI SRE/Skills"
],
"security": [
{
"AppKeyAuth": []
}
],
"x-mint": {
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **60 requests/minute**; **5 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Returns the raw zip bytes (`application/zip`), not the JSON envelope. The filename is the skill name.\n",
"href": "/en/api-reference/ai-sre/skills/skill-read-download",
"metadata": {
"sidebarTitle": "Download skill"
}
},
"responses": {
"200": {
"description": "Skill archive (zip).",
"headers": {
"Content-Disposition": {
"description": "attachment; filename=<skill_name>.zip",
"schema": {
"type": "string"
}
}
},
"content": {
"application/zip": {
"schema": {
"type": "string",
"format": "binary"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkillDownloadRequest"
},
"example": {
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
}
}
}
}
}
},
"/safari/skill/enable": {
"post": {
"operationId": "skill-read-enable",
Expand Down Expand Up @@ -39844,19 +39776,6 @@
"description"
]
},
"SkillDownloadRequest": {
"type": "object",
"description": "Skill zip download by ID.",
"properties": {
"skill_id": {
"type": "string",
"description": "Target skill ID."
}
},
"required": [
"skill_id"
]
},
"GetWarRoomDefaultObserversResponse": {
"type": "object",
"properties": {
Expand Down
81 changes: 0 additions & 81 deletions api-reference/openapi.zh.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20856,74 +20856,6 @@
}
}
},
"/safari/skill/download": {
"post": {
"operationId": "skill-read-download",
"summary": "下载技能",
"description": "按 ID 下载技能的 zip 压缩包。",
"tags": [
"AI SRE/技能"
],
"security": [
{
"AppKeyAuth": []
}
],
"x-mint": {
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **60 次/分钟**；**5 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- 返回原始 zip 字节流（`application/zip`），而非 JSON 信封。文件名为技能名称。\n",
"href": "/zh/api-reference/ai-sre/skills/skill-read-download",
"metadata": {
"sidebarTitle": "下载技能"
}
},
"responses": {
"200": {
"description": "技能压缩包（zip）。",
"headers": {
"Content-Disposition": {
"description": "attachment; filename=<skill_name>.zip",
"schema": {
"type": "string"
}
}
},
"content": {
"application/zip": {
"schema": {
"type": "string",
"format": "binary"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkillDownloadRequest"
},
"example": {
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
}
}
}
}
}
},
"/safari/skill/enable": {
"post": {
"operationId": "skill-read-enable",
Expand Down Expand Up @@ -39835,19 +39767,6 @@
"description"
]
},
"SkillDownloadRequest": {
"type": "object",
"description": "按 ID 下载技能压缩包。",
"properties": {
"skill_id": {
"type": "string",
"description": "目标技能 ID。"
}
},
"required": [
"skill_id"
]
},
"GetWarRoomDefaultObserversResponse": {
"type": "object",
"properties": {
Expand Down
81 changes: 0 additions & 81 deletions api-reference/safari.openapi.en.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -519,74 +519,6 @@
}
}
},
"/safari/skill/download": {
"post": {
"operationId": "skill-read-download",
"summary": "Download skill",
"description": "Download a skill's zip archive by ID.",
"tags": [
"AI SRE/Skills"
],
"security": [
{
"AppKeyAuth": []
}
],
"x-mint": {
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **60 requests/minute**; **5 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- Returns the raw zip bytes (`application/zip`), not the JSON envelope. The filename is the skill name.\n",
"href": "/en/api-reference/ai-sre/skills/skill-read-download",
"metadata": {
"sidebarTitle": "Download skill"
}
},
"responses": {
"200": {
"description": "Skill archive (zip).",
"headers": {
"Content-Disposition": {
"description": "attachment; filename=<skill_name>.zip",
"schema": {
"type": "string"
}
}
},
"content": {
"application/zip": {
"schema": {
"type": "string",
"format": "binary"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkillDownloadRequest"
},
"example": {
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
}
}
}
}
}
},
"/safari/skill/enable": {
"post": {
"operationId": "skill-read-enable",
Expand Down Expand Up @@ -2785,19 +2717,6 @@
"skill_id"
]
},
"SkillDownloadRequest": {
"type": "object",
"description": "Skill zip download by ID.",
"properties": {
"skill_id": {
"type": "string",
"description": "Target skill ID."
}
},
"required": [
"skill_id"
]
},
"SkillUpdateRequest": {
"type": "object",
"description": "Editable skill metadata.",
Expand Down
81 changes: 0 additions & 81 deletions api-reference/safari.openapi.zh.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -519,74 +519,6 @@
}
}
},
"/safari/skill/download": {
"post": {
"operationId": "skill-read-download",
"summary": "下载技能",
"description": "按 ID 下载技能的 zip 压缩包。",
"tags": [
"AI SRE/技能"
],
"security": [
{
"AppKeyAuth": []
}
],
"x-mint": {
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **60 次/分钟**；**5 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- 返回原始 zip 字节流（`application/zip`），而非 JSON 信封。文件名为技能名称。\n",
"href": "/zh/api-reference/ai-sre/skills/skill-read-download",
"metadata": {
"sidebarTitle": "下载技能"
}
},
"responses": {
"200": {
"description": "技能压缩包（zip）。",
"headers": {
"Content-Disposition": {
"description": "attachment; filename=<skill_name>.zip",
"schema": {
"type": "string"
}
}
},
"content": {
"application/zip": {
"schema": {
"type": "string",
"format": "binary"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadRequest"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SkillDownloadRequest"
},
"example": {
"skill_id": "skill_8s7Hn2kLpQ3xYbVc4Wd2m"
}
}
}
}
}
},
"/safari/skill/enable": {
"post": {
"operationId": "skill-read-enable",
Expand Down Expand Up @@ -2785,19 +2717,6 @@
"skill_id"
]
},
"SkillDownloadRequest": {
"type": "object",
"description": "按 ID 下载技能压缩包。",
"properties": {
"skill_id": {
"type": "string",
"description": "目标技能 ID。"
}
},
"required": [
"skill_id"
]
},
"SkillUpdateRequest": {
"type": "object",
"description": "可编辑的技能元数据。",
Expand Down
2 changes: 0 additions & 2 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1058,7 +1058,6 @@
"POST /safari/skill/update",
"POST /safari/skill/delete",
"POST /safari/skill/upload",
"POST /safari/skill/download",
"POST /safari/skill/enable",
"POST /safari/skill/disable"
]
Expand Down Expand Up @@ -2179,7 +2178,6 @@
"POST /safari/skill/update",
"POST /safari/skill/delete",
"POST /safari/skill/upload",
"POST /safari/skill/download",
"POST /safari/skill/enable",
"POST /safari/skill/disable"
]
Expand Down
Loading