Skip to main content
POST
Register a model entry

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

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
string<date-time>
required

When it was first stored.

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.