Skills

Import skills from uploaded files

Imports skills from uploaded files or ZIP archives into the workspace.

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

Path parameters

wIdstring required

Unique string identifier for the workspace

Response

Skills import result.

Example response

{
  "imported": [
    {
      "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"
          }
        }
      ]
    }
  ],
  "updated": [
    {
      "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 10 of the 86 revisions of this API.1023

Sep 1, 2026bd1d5314caa82See the full diff
- ○
  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
Aug 11, 2026f25d104430061See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Jul 30, 20269422ad6a05862See the full diff
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
Jul 23, 2026116e01494c544See the full diff
- ○
  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
- ○
  response property imported/items/isDefault deprecated
  response-property-deprecated
- ○
  response property updated/items/isDefault deprecated
  response-property-deprecated
Jun 26, 2026668391a8c2ed4See the full diff
- ●
  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
- ●
  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
Jun 25, 20263f92cf20c92d1See the full diff
- ○
  added the new optional request property
  new-optional-request-property
Jun 24, 20269841fb6b31344See the full diff
- ○
  response property imported/items/extendedSkillId deprecated
  response-property-deprecated
- ○
  response property imported/items/isExtendable deprecated
  response-property-deprecated
- ○
  response property updated/items/extendedSkillId deprecated
  response-property-deprecated
- ○
  response property updated/items/isExtendable deprecated
  response-property-deprecated
Jun 19, 2026e5d6a51d91df14See the full diff
- ●
  removed the request property
  request-property-removed
- ○
  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
- ○
  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
Jun 17, 20268848d86acfa541See the full diff
- ●
  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
- ●
  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
- ○
  added the new optional request property
  new-optional-request-property
Jun 7, 2026d541dc9c10e114See the full diff
- ●
  removed the request property
  request-property-removed
- ○
  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
- ○
  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 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history