List skills
Retrieves the custom skills in the workspace. Active skills are returned by default.
Path parameters
Unique string identifier for the workspace
Query parameters
Filter skills by status. Defaults to active.
Filter skills by availability. Repeatable to match several values. Unpublished (editors) skills are only returned when bypassEditorVisibility is set.
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 statusresponse-optional-property-added
- ○
- ○
added the required property
////to the response with the statusresponse-required-property-added
- ○
- ○
added the new optional
queryrequest parameterbypassEditorVisibilitynew-optional-request-parameter
- ○
- ○
added the new optional
queryrequest parameteravailabilitynew-optional-request-parameter
- ○
- ●
deleted the
queryrequest parameteravailabilityrequest-parameter-removed
- ●
- ○
added the new optional
queryrequest parameteravailabilitynew-optional-request-parameter
- ○
added the optional property
//to the response with the statusresponse-optional-property-added
- ○
response property
skills/items/isDefaultdeprecatedresponse-property-deprecated
- ○
- ●
removed the optional property
//from the response with the statusresponse-optional-property-removed
- ●
removed the optional property
//from the response with the statusresponse-optional-property-removed
- ●
- ○
response property
skills/items/extendedSkillIddeprecatedresponse-property-deprecated
- ○
response property
skills/items/isExtendabledeprecatedresponse-property-deprecated
- ○
- ○
added the optional property
//to the response with the statusresponse-optional-property-added
- ○
added the optional property
//to the response with the statusresponse-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 statusresponse-optional-property-removed
- ●
removed the optional property
//from the response with the statusresponse-optional-property-removed
- ●