manage_models

Management

Manage Models

CRUD for models. Actions: list, get, create, update, delete, copy, transfer, download. Tag management: list_tags, add_tags, remove_tags. Args: - action: required operation (see above) - model_id: required for get, update, delete, copy, transfer, download, add_tags, remove_tags - data: model payload for create or update - target_project_id: required for transfer - filters: optional for list — privacy, status, modality - tags: required for add_tags and remove_tags - response_format: 'json' (default) or 'markdown' - team_id, project_id: required for OAuth callers Returns: model metadata (JSON or markdown). list returns a paginated array — use page_token for the next page. list_tags returns the shared tag namespace. Examples: - "List my image models" -> action="list", filters={"privacy": "private", "modality": "image"} - "Get this model" -> action="get", model_id="model_xxx" - "Transfer this model" -> action="transfer", model_id="model_xxx", target_project_id="project_xxx" - "Add tags to this model" -> action="add_tags", model_id="model_xxx", tags=["hero", "anime"] Don't use when: You need to find a model by name or intent. Prefer search with target="models" instead.

destructiveopen-world

Parameters

NameTypeRequiredDescription
actionenum(list | get | create | update | delete | copy | transfer | download | list_tags | add_tags | remove_tags)Model action: list, get, create, update, delete, copy, transfer, download, list_tags, add_tags, or remove_tags.
model_idstringModel ID (required for get/update/delete/copy/transfer/download).
filtersunknownFilters for list action.
datarecordModel data for create/update.
target_project_idstringDestination project ID for transfer.
tagsarrayTags to add or remove (for add_tags/remove_tags actions).
limitnumber20Results per page.
page_tokenstringPagination token.
team_idstringTeam ID. Required if user belongs to multiple teams.
project_idstringProject ID to scope the operation to.
response_formatenum(json | markdown)jsonOutput format: 'json' for structured data, 'markdown' for human-readable text.

Example Request

JSON
{
  "action": "list",
  "filters": {
    "modality": "image",
    "status": "trained"
  },
  "limit": 20,
  "team_id": "team_abc123",
  "project_id": "proj_xyz789"
}

Example Response

JSON
{
  "models": [
    {
      "id": "model_custom_abc",
      "name": "My Dragon Style",
      "status": "trained",
      "modality": "image"
    }
  ]
}

Common Use Cases

  • List all trained models in a project before selecting one for generation
  • Create a new model placeholder before uploading training images
  • Transfer a trained model to another project for reuse across teams
  • Copy a model to create a variant with a different training configuration