CreateFamilyRequest

POST /v1/artifacts/families. The id is the caller's, so a retried creation is refused as a duplicate rather than made twice.

Type object

Shape

Field	Type	Description
family_idrequired	ArtifactFamilyId
workspacerequired	WorkspaceId
titlerequired	ArtifactTitle	The title a result is named by on a device that cannot open its bytes (D27). A title is content: it is redacted like the objective.
created_by_run	RunId or null

Example

{
  "family_id": "00000000-0000-4000-8000-000000000000",
  "workspace": "00000000-0000-4000-8000-000000000000",
  "title": "string",
  "created_by_run": "00000000-0000-4000-8000-000000000000"
}

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/families
Create an artifact family

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