List Skills

Retrieve Skills in your workspace

GET /skills/v1

List Skills

cURL

curl --request GET \
  --url https://api.langdock.com/skills/v1 \
  --header 'Authorization: Bearer <token>'

200

{
  "skills": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "instructions": "<string>",
      "integrationIds": [
        "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "nextCursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Returns Skills in your workspace. Use query parameters to paginate, search, or filter by slug.

Base URL

https://api.langdock.com/skills/v1

Dedicated deployments

Replace api.langdock.com with <your-deployment-url>/api/public in all requests.

Required Scopes

This endpoint requires the SKILL_API scope.

Parameters

Parameter	Type	Required	Description
limit	integer	No	Number of Skills to return. Default: 50. Maximum: 250.
cursor	string	No	Cursor from the previous response for pagination.
query	string	No	Search query for matching Skills.
slug	string	No	Filter by Skill slug. Must use lowercase letters, numbers, and dashes.

Example

const axios = require("axios");

async function listSkills() {
  const response = await axios.get("https://api.langdock.com/skills/v1", {
    params: {
      limit: 25,
      query: "support"
    },
    headers: {
      Authorization: "Bearer YOUR_API_KEY"
    }
  });

  console.log("Skills:", response.data.skills);
  return response.data.nextCursor;
}

listSkills();

Response Format

Success Response (200 OK)

{
  skills: Array<{
    id: string;
    name: string;
    slug: string;
    description: string;
    instructions: string;
    integrationIds: string[];
    createdAt: string;
    updatedAt: string;
  }>;
  nextCursor?: string;
}

Example Response

{
  "skills": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Support Reply Style",
      "slug": "support-reply-style",
      "description": "Applies the support team's tone and escalation rules.",
      "instructions": "Write concise replies, include the next best action, and escalate billing issues to the account owner.",
      "integrationIds": [],
      "createdAt": "2026-07-06T10:30:00.000Z",
      "updatedAt": "2026-07-06T10:30:00.000Z"
    }
  ],
  "nextCursor": "550e8400-e29b-41d4-a716-446655440000"
}

Error Handling

Status Code	Description
400	Invalid query parameter
401	Invalid or missing API key
403	Missing SKILL_API scope or Skills product access
429	Rate limit exceeded
500	Internal server error

Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.

Authorizations

Authorization · string · header · required

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Query Parameters

limit · integer · default: 50

Number of Skills to return.

Required range: 1 <= x <= 250

cursor · string<uuid>

Cursor from the previous response for pagination.

query · string

Search query for matching Skills.

slug · string

Filter by Skill slug.

Maximum string length: 100

Pattern: ^[a-z0-9-]+$

Response

200

application/json

Skills returned successfully

skills · object[] · required

Show child attributes

nextCursor · string<uuid>

Cursor for the next page, if more results are available.