> ## Documentation Index
> Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# skill.detail
> Retrieves one skill's details and a temporary download URL for its current archive.
Questions or issues? Contact us at [api-support@manus.ai](mailto:api-support@manus.ai).
> [!TIP]
>
> **Auth:**
>
> * **API Key:** Any skill the user can download in Manus: own, team, project (read access), official, installed Hub, and authorized App skills.
> * **Standard OAuth client:** Requires `create_task` or `manage_all_tasks`. Only skills owned by this App; other IDs return `NotFound` (HTTP 404).
> * **Trusted client:** Same as API Key.
The endpoint returns one skill's metadata and a download link for its current archive. Download the archive and read `SKILL.md` inside it when you need the skill's front matter or files. The download link expires after 24 hours; call `skill.detail` again for a new link. Earlier versions are not returned. Use [skill.list](https://open.manus.ai/docs/v2/skill.list.md) to get skill IDs.
## OpenAPI
````yaml GET /v2/skill.detail
openapi: 3.1.0
info:
title: Manus OpenAPI v2
description: >-
API for integrating Manus into your workflow. All responses are wrapped with
{"ok": true, "request_id": "...", ...} for success and {"ok": false,
"request_id": "...", "error": {"code": "...", "message": "..."}} for errors.
version: 2.0.0
servers:
- url: https://api.manus.ai
security:
- ApiKeyAuth: []
paths:
/v2/skill.detail:
get:
summary: GetSkill
description: >-
Retrieves one skill's details and a temporary download URL for its
current archive.
operationId: openapi.v2.OpenapiV2Service.GetSkill
parameters:
- name: x-manus-api-key
in: header
required: false
schema:
type: string
description: >-
API key for direct authentication. Provide either this or
`Authorization`, not both. See
[Authentication](https://open.manus.ai/docs/v2/authentication).
- name: Authorization
in: header
required: false
schema:
type: string
example: Bearer {access_token}
description: >-
OAuth access token. Standard OAuth clients require `create_task` or
`manage_all_tasks`. Trusted clients bypass endpoint scope
restrictions. See the [Open
App](https://open.manus.ai/docs/v2/open-app) guide.
- name: skill_id
in: query
required: true
schema:
type: string
description: >-
Use [skill.list](https://open.manus.ai/docs/v2/skill.list) to get
skill IDs.
responses:
'200':
description: Skill retrieved successfully.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
example: true
description: Whether the request was successful.
request_id:
type: string
description: Unique identifier for this API request.
skill:
$ref: '#/components/schemas/Skill'
download_info:
type: object
description: Download link for the skill's current archive.
properties:
download_url:
type: string
format: uri
description: >-
Presigned GET URL for the current version's `.skill`
archive (zip). Use it as returned, without Manus
credentials. Valid for 24 hours; call `skill.detail`
again for a fresh link.
filename:
type: string
example: web-system-design.skill
description: File name of the archive.
expires_at:
type: string
pattern: ^[0-9]+$
example: '1893456000'
description: >-
Unix timestamp in seconds when download_url expires,
serialized as a decimal string by protobuf JSON.
example:
ok: true
request_id:
skill:
id:
name: Web System Design
description: Design scalable web systems.
owner_type: personal
creator_info:
user_id:
name: Alex
created_at: 1767225600
updated_at: 1767225600
download_info:
download_url: https://
filename: web-system-design.skill
expires_at: '1893456000'
4XX:
description: Error response.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
security: []
x-codeSamples:
- lang: bash
label: cURL
source: |-
curl --request GET \
--url 'https://api.manus.ai/v2/skill.detail?skill_id=' \
--header 'x-manus-api-key: '
components:
schemas:
Skill:
type: object
description: A skill that extends the agent's capabilities.
properties:
id:
type: string
description: >-
Unique identifier for the skill. Use this in enable_skills or
force_skills when creating tasks.
name:
type: string
description: Display name of the skill.
description:
type: string
description: What the skill does and when it's useful.
owner_type:
type: string
enum:
- personal
- official
- team
- project
- app
- hub
- device
- unknown
description: |-
Who owns the skill.
- `personal` — user-created skill.
- `official` — built-in system skill.
- `team` — team-shared skill.
- `project` — project-specific skill.
- `app` — private skill owned by an Open App.
- `hub` — skill installed from Skill Hub.
- `device` — skill discovered on the user's connected device.
- `unknown` — ownership not recognized.
Treat any unrecognized value as `unknown`; new values may be added.
creator_info:
type: object
description: Information about who created the skill.
properties:
user_id:
type: string
description: User ID of the skill creator.
name:
type: string
description: Display name of the skill creator.
created_at:
type: integer
format: int64
description: Unix timestamp (seconds) when the skill was created.
updated_at:
type: integer
format: int64
description: Unix timestamp (seconds) when the skill was last updated.
ErrorResponse:
type: object
description: Standard error response format returned when a request fails.
properties:
ok:
type: boolean
example: false
description: Always false for error responses.
request_id:
type: string
description: >-
Unique identifier for this API request, useful for debugging with
support.
error:
type: object
description: Error details.
properties:
code:
type: string
description: >-
Machine-readable error code (e.g., "invalid_argument",
"not_found", "permission_denied", "rate_limited").
message:
type: string
description: Human-readable error description explaining what went wrong.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-manus-api-key
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.