Get Skill File Route
Fetch one or more files from a skill version's file tree.
Provide path for a single file or paths (repeatable) for a batch. At least one of the two parameters is required; supplying neither returns a validation error. Returns content inline for text files and small binary files; binary files over the size limit return metadata with an error field instead of inline bytes. Batch responses carry an additional batch_response_cap_exceeded error when the aggregate inline budget is exhausted.
Pass format=raw with a single path to receive the file's raw bytes instead of the JSON envelope. Raw serving applies no inline size ceiling, so it is the path the CLI's sync pull uses to mirror a binary too large to inline (a demo image or asset) down to disk. Pair format=raw with sha256 to content-address the fetch. Every raw response carries the same hardening headers as the template raw route, so a file can never execute as an active document in a browser. format is ignored for a batch (paths) request; raw is single-file only.
Request
- Base URL: https://api.goodeye.dev/v1
- URL: https://api.goodeye.dev/v1/skills/{id_or_slug}/files
- Auth: none declared
Path parameters
Query parameters
Relative path of the file within the skill's file tree
One or more relative paths for a batch fetch. Repeat the parameter for each path: ?paths=a.txt&paths=b.txt. Mutually exclusive with path.
Set to 'raw' to return a single file's raw bytes instead of the JSON envelope. Unlike the inline JSON response, raw serving has no binary size ceiling, so it is the only way to retrieve a binary larger than the inline limit. Requires 'path' (not 'paths'); omit for the default structured JSON response.
Content address of the expected file. When provided with format=raw, the file is resolved by path and then confirmed to match this value; a stale or mismatched address returns not found.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.