RegisterFileRequest

POST /v1/artifacts/runs/{run}/register - D19's one click.

The title is optional because the click carries no words: absent, the file's own last segment names the result, which is what the person is looking at when they press it.

Type object

Shape

Field	Type	Description
pathrequired	RelativePath	A file's place inside a run's `.artifacts/<RunId>/` folder: `/`-separated, never absolute, never carrying a parent-directory step. Content, like a filename, so its `Debug` redacts. It is a statement of where to look, never an authority to look there: the register path rule (`staging::stage`) still resolves it, walks it for links and proves containment. Refusing the obvious faults here as well means a listing this type could not have produced can never be echoed back as a registration.
title	ArtifactTitle or null
mime	MediaType or null

Example

{
  "path": "string",
  "title": "string",
  "mime": "string"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Used by

POST/v1/artifacts/runs/{run}/register
Register a file the run left in its results folder (D19)

Generated from contract version 1. Last updated November 12, 2026.