skill.list

Lists available skills. Includes project skills when project_id is provided. Use the returned IDs in enable_skills or force_skills of task.create.

GET /v2/skill.list

ListSkills

cURL

curl --request GET \
  --url https://api.manus.ai/v2/skill.list

200

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "creator_info": {
        "user_id": "<string>",
        "name": "<string>"
      },
      "created_at": 123,
      "updated_at": 123
    }
  ]
}

^{Questions or issues? Contact us at [e-mail].}

OAuth scope: create_task or manage_all_tasks — see the OAuth2 guide. With OAuth, results may include private skills bound to this OAuth app.

Use in tasks: Pass the returned skill IDs in enable_skills or force_skills of task.create.

Headers

x-manus-api-key · string

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

Authorization · string

OAuth2 access token in Bearer {token} format. Provide either this or x-manus-api-key, not both. See the OAuth2 guide.

Example:

"Bearer {access_token}"

Query Parameters

project_id · string

When provided, includes project-specific skills in addition to the user's global skills. Use project.list to get available project IDs.

Response

200

application/json

Skills retrieved successfully.

ok · boolean

Whether the request was successful.

Example:

true

request_id · string

Unique identifier for this API request.

data · object[]

Array of skill objects. Use the id field when passing to enable_skills or force_skills in task.create.

Hide child attributes

data. id · string

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

data. name · string

Display name of the skill.

data. description · string

What the skill does and when it's useful.

data. 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.

Available options: personal, official, team, project

data. creator_info · object

Information about who created the skill.

Hide child attributes

data.creator_info. user_id · string

User ID of the skill creator.

data.creator_info. name · string

Display name of the skill creator.

data. created_at · integer<int64>

Unix timestamp (seconds) when the skill was created.

data. updated_at · integer<int64>

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