DUdust-tt
Skills

List skills

Changed on

Retrieves the custom skills in the workspace. Active skills are returned by default.

get/api/v1/w/{wId}/skills

Request

Path parameters

wIdstring required

Unique string identifier for the workspace

Query parameters

status'active' | 'archived' | 'suggested'

Filter skills by status. Defaults to active.

availabilitystring[]

Filter skills by availability. Repeatable to match several values. Unpublished (editors) skills are only returned when bypassEditorVisibility is set.

bypassEditorVisibilityboolean

When true, also return unpublished (editors) skills. Requires an admin API key.

Response

Skills available in the workspace.

Example response

{
  "skills": [
    {
      "sId": "skill_abc123",
      "status": "active",
      "name": "Customer Support",
      "agentFacingDescription": "Use this skill to answer customer support questions.",
      "userFacingDescription": "Answers support questions with the right workspace context.",
      "icon": "ActionRobotIcon",
      "sourceMetadata": {
        "repoUrl": "https://github.com/dust-tt/skills",
        "filePath": "support/SKILL.md"
      },
      "tools": [
        {
          "id": 123,
          "sId": "mcp_sv_abc123",
          "name": "My Custom MCP Server",
          "description": "This MCP server handles customer data operations",
          "createdAt": 1625097600,
          "updatedAt": 1625184000,
          "spaceId": "spc_xyz789",
          "serverType": "remote",
          "server": {
            "sId": "mcp_srv_def456",
            "name": "Customer Data Server",
            "version": "1.0.0",
            "description": "Handles customer data operations and queries",
            "icon": "database",
            "authorization": {
              "provider": "github",
              "supported_use_cases": [
                "platform_actions"
              ],
              "scope": "repo:read"
            },
            "tools": [
              {
                "name": "query_customers",
                "description": "Query customer database for information",
                "inputSchema": {
                  "type": "object",
                  "properties": {
                    "customerId": {
                      "type": "string"
                    }
                  }
                }
              }
            ],
            "availability": "production",
            "documentationUrl": "https://docs.example.com/mcp-server"
          },
          "oAuthUseCase": "platform_actions",
          "editedByUser": {
            "editedAt": 1625184000,
            "fullName": "John Doe",
            "imageUrl": "https://example.com/profile/johndoe.jpg"
          }
        }
      ]
    }
  ]
}

Changes