Get Skill File

Retrieve a stored Skill file by path

GET /skills/v1/{skillId}/files

Get a Skill file

cURL

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

200

{
  "path": "<string>",
  "sizeBytes": 123,
  "extension": "<string>",
  "hasScript": true,
  "sha256": "<string>",
  "content": "<string>"
}

Retrieves a stored Skill file by path from your workspace.

Base URL

https://api.langdock.com/skills/v1/{skillId}/files

Dedicated deployments

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

Required Scopes

This endpoint requires the SKILL_API scope.

Requires viewer access to the Skill.

Parameters

Parameter	Type	Required	Description
skillId	string	Yes	UUID of the Skill to retrieve.
path	string	Yes	Relative path of the file inside the Skill, for example references/template.md. Maximum: 255 characters. Absolute paths, drive-prefixed paths, control characters, and .. segments are rejected.

The file must be valid UTF-8 and no larger than 512 KB. Readable extensions are .md, .mdx, .txt, .py, .sh, .js, .ts, .json, .yaml, .yml, .toml, .csv, .xml, .xsd, .html, .css, and .svg. Binary and other unsupported files stay listed on Get Skill. This endpoint does not return their contents.

Example

const axios = require("axios");

async function getSkillFile(skillId, path) {
  const response = await axios.get(
    `https://api.langdock.com/skills/v1/${skillId}/files`,
    {
      params: { path },
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Content:", response.data.content);
}

getSkillFile(
  "550e8400-e29b-41d4-a716-446655440000",
  "references/template.md"
);

Response Format

Success Response (200 OK)

{
  path: string;
  sizeBytes: number;
  extension: string;
  hasScript: boolean;
  sha256: string;
  content: string;
}

Error Handling

Status Code	Description
400	Invalid Skill ID, invalid path, unsupported file type, invalid UTF-8, or file larger than 512 KB
401	Invalid or missing API key
403	Missing SKILL_API scope or Skills product access
404	Skill or file not found, or not accessible
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"

Path Parameters

skillId · string<uuid> · required

UUID of the Skill.

Query Parameters

path · string · required

Relative path of the file inside the Skill.

Required string length: 1 - 255

Response

200

application/json

File returned successfully

path · string · required

Relative path inside the Skill.

sizeBytes · integer · required

File size in bytes.

extension · string · required

Lowercase file extension, including the leading dot.

hasScript · boolean · required

Whether the file is a script file (.py, .sh, .js, or .ts).

sha256 · string · required

Lowercase SHA-256 hash of the original file bytes.

content · string · required

UTF-8 file contents.