models

Model-kind repo extras — model meta

1 operation · 1 schema

PUT `/v1/models/{owner}/{repo}/meta`

Set model meta

putModelMeta · scope key:write

Full replace of the model meta block on a model-kind repo (the M7 worker sets source_run_id when packaging a trained model). 409 problem if the repo kind is not model. UI-API: robot must be a robot repo the caller can read — a missing, private or malformed one is the same 422, word for word — and embodiment_fingerprint is the interface fingerprint the policy's manifest records.

Parameters

putModelMeta parameters
Name	In	Type	Description
`owner`required	path	`Handle`	Repo owner handle (username or org slug).
`repo`required	path	`Slug`	Repo slug.

Request body

application/json · required · ModelMetaPut

putModelMeta request body
Field	Type	Description
`policy_type`required	`string` length ≤ `128`
`base_model`	`string \| null` length ≤ `256`
`source_run_id`	`string \| null`	Must reference an existing run visible to the caller.
`control_class`	`ControlClass \| null`	`reflex` \| `skill` \| `planner` (M15). Omit or null to leave it undeclared.
`robot`	`string \| null` length ≤ `129` · pattern `^[a-z0-9](?:[a-z0-9-][a-z0-9])?/[a-z0-9](?:[a-z0-9-][a-z0-9])?$`	UI-API: `owner/slug` of the robot repo the policy was built for. It must be a robot repo the caller can read: a missing, private or malformed one is the same `422`, word for word. Omit or null to record none (a full replace clears it).
`embodiment_fingerprint`	`string \| null` pattern `^[0-9a-f]{64}$`	UI-API: the interface fingerprint the policy's manifest records (`embodiment_fingerprint`, M17b). Never derived: omit it when the manifest has none.

Responses

putModelMeta responses
Status	Description	Body
`200`	Stored model meta.	`ModelMeta`
`401`	Missing or invalid credentials.	`Problem`application/problem+json
`403`	Authenticated but not allowed (visibility, membership or scope).	`Problem`application/problem+json
`404`	Resource not found (or hidden from the caller).	`Problem`application/problem+json
`409`	State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).	`Problem`application/problem+json
`422`	Request failed validation.	`Problem`application/problem+json

Schemas (1)

The schemas these operations reach before any other tag’s do. A type that links elsewhere is rendered on that tag’s page.

ModelMetaPut

object

ModelMetaPut fields
Field	Type	Description
`policy_type`required	`string` length ≤ `128`
`base_model`	`string \| null` length ≤ `256`
`source_run_id`	`string \| null`	Must reference an existing run visible to the caller.
`control_class`	`ControlClass \| null`	`reflex` \| `skill` \| `planner` (M15). Omit or null to leave it undeclared.
`robot`	`string \| null` length ≤ `129` · pattern `^[a-z0-9](?:[a-z0-9-][a-z0-9])?/[a-z0-9](?:[a-z0-9-][a-z0-9])?$`	UI-API: `owner/slug` of the robot repo the policy was built for. It must be a robot repo the caller can read: a missing, private or malformed one is the same `422`, word for word. Omit or null to record none (a full replace clears it).
`embodiment_fingerprint`	`string \| null` pattern `^[0-9a-f]{64}$`	UI-API: the interface fingerprint the policy's manifest records (`embodiment_fingerprint`, M17b). Never derived: omit it when the manifest has none.