Skip to main content
POST
Go (SDK)

Authorizations

Authorization
string
header
required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json
name
string
required

The repository name. Must start with an alphanumeric character and be ≤100 characters of [A-Za-z0-9._-].

Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$
Example:

"my-model"

description
string
kind
enum<string>
default:repo

What the repository will hold. Defaults to repo.

Available options:
repo,
model,
dataset,
image

Response

The created repository.

created_at
string<date-time>
required
creator
string | null
required

The user id of whoever created the repository, through any plane (the API, git push, the HF client, the OCI registry). It is the same id the platform session and mk-authentication's members directory use, so a name is one directory lookup away. null for a repository that records no user id; never an empty string.

Example:

"usr_01j9z8w3k6m2q4r7t9v1x3y5z7"

description
string
required
Example:

"Fine-tuned weights for the acme assistant."

id
string
required

Opaque, stable repository id (the canonical key; not a user label).

Example:

"rqz4h6k2m5n7p9r3t5v7w9x2"

kind
enum<string> | null
required

The repository's kind, or null for a legacy repository created before kinds existed and not yet typed through PATCH. An untyped repository is served by every plane.

Available options:
repo,
model,
dataset,
image
Example:

"model"

name
string
required

The repository name (URL label).

Example:

"my-model"

org
string
required

The organization URL slug the repository belongs to.

Example:

"acme"