> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Models

> List, retrieve, update, and delete your organization's models.

Manage your organization's model catalog. These endpoints read and edit models that
already exist — to create one, see
[Model Training](/api-reference/model-training/overview).

* [`GET /models`](/api-reference/models/list) — list your organization's models,
  most recent first; filter by `category` and/or `status`, paginate with
  `limit`/`offset`.
* [`GET /models/{id}`](/api-reference/models/get) — full detail for one model,
  including presigned reference-image URLs, the default prompt, and trigger words.
* [`PATCH /models/{id}`](/api-reference/models/update) — update the editable fields
  (`name`, `default_prompt`).
* [`DELETE /models/{id}`](/api-reference/models/delete) — soft-delete a model so it
  stops appearing in the app and the API.

Reads require the `models.read` scope; `PATCH` and `DELETE` require `models.write`.
Ownership and privacy fields cannot be changed, and an id owned by another
organization returns [`404 not_found`](/guides/errors#not_found).