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.

get/skills/{id_or_slug}/files

Request

  • Base URL: https://api.goodeye.dev/v1
  • URL: https://api.goodeye.dev/v1/skills/{id_or_slug}/files
  • Auth: none declared

Path parameters

id_or_slugstring required

Query parameters

pathstring nullable

Relative path of the file within the skill's file tree

pathsstring[] nullable

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.

versioninteger nullable
formatstring nullable

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.

sha256string nullable

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

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.