Skip to main content
POST
Register a model entry

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Body

application/json

Registers a model against a stored credential.

agentsfleet ignores fields it does not know, instead of refusing the request.

model_id
string
required

The model to register.

secret_ref
string
required

The credential to back it with. Immutable once the entry exists.

Response

Created

What a create and a model change both answer with.

One shape for both verbs because both say the same thing — which entry now stands — and the status code is what distinguishes them.

created_at
integer<int64>
required

When it was first stored, in epoch milliseconds.

id
string
required

The entry's identity.

model_id
string
required

The model it configures.

secret_ref
string
required

The vault key name backing it.