Skills

List skills

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

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

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

Changed in 11 of the 86 revisions of this API.513

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the required property //// to the response with the status

      response-required-property-added

    • added the new optional query request parameter bypassEditorVisibility

      new-optional-request-parameter

    • added the new optional query request parameter availability

      new-optional-request-parameter

    • deleted the query request parameter availability

      request-parameter-removed

    • added the new optional query request parameter availability

      new-optional-request-parameter

    • added the optional property // to the response with the status

      response-optional-property-added

    • response property skills/items/isDefault deprecated

      response-property-deprecated

    • removed the optional property // from the response with the status

      response-optional-property-removed

    • removed the optional property // from the response with the status

      response-optional-property-removed

    • response property skills/items/extendedSkillId deprecated

      response-property-deprecated

    • response property skills/items/isExtendable deprecated

      response-property-deprecated

    • added the optional property // to the response with the status

      response-optional-property-added

    • added the optional property // to the response with the status

      response-optional-property-added

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the optional property // from the response with the status

      response-optional-property-removed

    • removed the optional property // from the response with the status

      response-optional-property-removed