Create model

Create a private model repository owned by a user or organization. The caller must be allowed to create repositories for owner.

POST/v1/models

Authorization

Authorizationstringrequired

Send a Modaic bearer token in the Authorization header.

Parameters

ownerstringrequired

The user or organization slug.

slugstringrequired

The model slug. It must start with an alphanumeric character and may contain letters, digits, ., _, and -, up to 100 characters.

descriptionstring

A description up to 1,000 characters.

defaultBranchstringdefault: main

The initial default branch.

initialFilesFileChange[]

Up to 20 initial files. Each item has operation: "upsert", a path up to 512 characters, and string contents up to 1,000,000 characters.

idUUIDrequired

The modelId used by model-scoped API routes.

ownerEntityrequired

Public metadata for the owning user or organization.

slugstringrequired

descriptionstring | nullrequired

defaultBranchstringrequired

visibilityprivaterequired

Model repositories are private.

createdAtISO 8601 datetimerequired

updatedAtISO 8601 datetimerequired

After creation, call Update model to set the root model and typed questions, or include a valid model.json in initialFiles.

Was this page helpful?