Create a Model in a namespace

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Kubernetes namespace of the resource.

Body Params

Model represents a stored or remotely-sourced AI model artifact within a namespace.
It carries descriptive metadata about the model (family, type, precision,
quantization, parameter count, etc.) and acts as the central identity that
ModelClass, LoRAAdapter, and FineTuningJob reference.

rackai.rackspace.com/uri-hash label with the following rules:

  • Controller service account (e.g. rackai-controller-manager) MAY add,
    update, or remove the label. The controller stamps it when cache=true is
    first reconciled and removes it during the cache=true→false cleanup path.
  • All other principals (end-users, CI, kubectl) MUST NOT modify or delete
    the label once it has been stamped. Reject the request with a clear
    message explaining that the label is managed by the controller.

A webhook is necessary here because CEL transition rules apply to ALL
mutations regardless of who makes them, so CEL cannot distinguish the
controller from a user and would block legitimate controller cleanup.

string

APIVersion defines the versioned schema of this representation of an object.
Servers should convert recognized schemas to the latest internal value, and
may reject unrecognized values.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

string

Kind is a string value representing the REST resource this object represents.
Servers may infer this from the endpoint the client submits requests to.
Cannot be updated.
In CamelCase.
More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata
object
spec
object
required

Spec defines the desired state of Model.

Responses

400

Bad Request — the request body or parameters are invalid.

401

Unauthorized — no or invalid bearer token provided.

403

Forbidden — the authenticated principal lacks permission.

409

Conflict — a resource with the same name already exists.

422

Unprocessable Entity — the object failed schema validation.

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json