skill.detail

GET

skill.detail

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/skill.detail?skill_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/skill.detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/skill.detail"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/skill.detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<request_id>",
  "skill": {
    "id": "<skill_id>",
    "name": "Web System Design",
    "description": "Design scalable web systems.",
    "owner_type": "personal",
    "creator_info": {
      "user_id": "<user_id>",
      "name": "Alex"
    },
    "created_at": 1767225600,
    "updated_at": 1767225600
  },
  "download_info": {
    "download_url": "https://<presigned-url>",
    "filename": "web-system-design.skill",
    "expires_at": "1893456000"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

^{Questions or issues? Contact us at api-support@manus.ai.}

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 to get skill IDs.

Headers

x-manus-api-key

string

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

Authorization

string

OAuth access token. Standard OAuth clients require create_task or manage_all_tasks. Trusted clients bypass endpoint scope restrictions. See the Open App guide.

Example:

"Bearer {access_token}"

Query Parameters

skill_id

string

required

Use skill.list to get skill IDs.

Response

Skill retrieved successfully.

boolean

Whether the request was successful.

Example:

true

request_id

string

Unique identifier for this API request.

skill

object

A skill that extends the agent's capabilities.

Hide child attributes

skill.id

string

Unique identifier for the skill. Use this in enable_skills or force_skills when creating tasks.

skill.name

string

Display name of the skill.

skill.description

string

What the skill does and when it's useful.

skill.owner_type

enum<string>

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.

Available options:

personal,

official,

team,

project,

app,

hub,

device,

unknown

skill.creator_info

object

Information about who created the skill.

Hide child attributes

skill.creator_info.user_id

string

User ID of the skill creator.

skill.creator_info.name

string

Display name of the skill creator.

skill.created_at

integer<int64>

Unix timestamp (seconds) when the skill was created.

skill.updated_at

integer<int64>

Unix timestamp (seconds) when the skill was last updated.

download_info

object

Download link for the skill's current archive.

Hide child attributes

download_info.download_url

string<uri>

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.

download_info.filename

string

File name of the archive.

Example:

"web-system-design.skill"

download_info.expires_at

string

Unix timestamp in seconds when download_url expires, serialized as a decimal string by protobuf JSON.

Pattern: ^[0-9]+$

Example:

"1893456000"

cURL

curl --request GET \
  --url 'https://api.manus.ai/v2/skill.detail?skill_id=<string>' \
  --header 'x-manus-api-key: <api-key>'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/skill.detail",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/skill.detail"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/skill.detail")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<request_id>",
  "skill": {
    "id": "<skill_id>",
    "name": "Web System Design",
    "description": "Design scalable web systems.",
    "owner_type": "personal",
    "creator_info": {
      "user_id": "<user_id>",
      "name": "Alex"
    },
    "created_at": 1767225600,
    "updated_at": 1767225600
  },
  "download_info": {
    "download_url": "https://<presigned-url>",
    "filename": "web-system-design.skill",
    "expires_at": "1893456000"
  }
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Headers

Query Parameters

Response