DUdust-tt
Skills

Import skills from uploaded files

Changed on

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

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

Request

Path parameters

wIdstring required

Unique string identifier for the workspace

Request body multipart/form-data

filesstring[] required

Skill files or ZIP archives to import. Skill names must be at most 256 characters.

namesstring[]

Optional skill names to import from the uploaded files.

onConflict'error' | 'skip' | 'override'

Strategy applied when a skill with the same name already exists in the workspace. error rejects the whole import, skip skips the skill and reports it in skipped, override updates the existing skill. Defaults to error.

editorsstring[]

Optional editor email addresses to add to imported or updated skills. Editors must be active workspace members. Existing skills keep their current editors.

availability'editors' | 'workspace_users' | 'users_and_agents'

Optional availability to apply to imported or updated skills. editors is unpublished, workspace_users is published, and users_and_agents is discoverable. New skills default to editors and existing skills keep their current availability when omitted.

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

  • aa52b0aedce0Revision changes
    • info

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

    • info

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

  • bd1d5314caa8Revision changes
    • info

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

    • info

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