Skip to main content
GET
Get a Skill file
Retrieves a stored Skill file by path from your workspace.

Base URL

Dedicated deploymentsReplace 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

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

Response Format

Success Response (200 OK)

Error Handling

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

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.