Models

Model configuration endpoints

Model configuration endpoints

List models

List models with cursor pagination.

GET
/models

Query Parameters

project?string

Project override

limit?integer

Page size (max 500)

cursor?string

Opaque pagination cursor

q?string

Filter by model ID prefix

Response Body

curl -X GET "https://loading/api/v0/models?project=string&limit=0&cursor=string&q=string"
{
  "data": {
    "models": [
      {
        "api_key": "string",
        "api_url": "string",
        "default": true,
        "etag": "abc123",
        "id": "string",
        "max_tool_iterations": 0,
        "model": "string",
        "organization": "string",
        "params": {
          "max_length": 0,
          "max_tokens": 0,
          "min_length": 0,
          "repetition_penalty": 0,
          "seed": 0,
          "stop_words": [
            "string"
          ],
          "temperature": 0,
          "top_k": 0,
          "top_p": 0
        },
        "provider": "string",
        "resource": "string"
      }
    ],
    "page": {
      "limit": 50,
      "next_cursor": "v2:after:tool-001",
      "prev_cursor": "v2:before:tool-000",
      "total": 2
    }
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Get model

Retrieve a model configuration by ID.

GET
/models/{model_id}

Path Parameters

model_idstring

Model ID

Query Parameters

project?string

Project override

Response Body

curl -X GET "https://loading/api/v0/models/string?project=string"
{
  "data": {
    "api_key": "string",
    "api_url": "string",
    "default": true,
    "id": "string",
    "max_tool_iterations": 0,
    "model": "string",
    "organization": "string",
    "params": {
      "max_length": 0,
      "max_tokens": 0,
      "min_length": 0,
      "repetition_penalty": 0,
      "seed": 0,
      "stop_words": [
        "string"
      ],
      "temperature": 0,
      "top_k": 0,
      "top_p": 0
    },
    "provider": "string",
    "resource": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Create or update model

Create a model when absent or update an existing one using strong ETag concurrency.

PUT
/models/{model_id}

Path Parameters

model_idstring

Model ID

Query Parameters

project?string

Project override

Header Parameters

If-Match?string

Strong ETag for optimistic concurrency

Model configuration payload

Empty Object

Response Body

curl -X PUT "https://loading/api/v0/models/string?project=string" \
  -H "If-Match: string" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "data": {
    "api_key": "string",
    "api_url": "string",
    "default": true,
    "id": "string",
    "max_tool_iterations": 0,
    "model": "string",
    "organization": "string",
    "params": {
      "max_length": 0,
      "max_tokens": 0,
      "min_length": 0,
      "repetition_penalty": 0,
      "seed": 0,
      "stop_words": [
        "string"
      ],
      "temperature": 0,
      "top_k": 0,
      "top_p": 0
    },
    "provider": "string",
    "resource": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "data": {
    "api_key": "string",
    "api_url": "string",
    "default": true,
    "id": "string",
    "max_tool_iterations": 0,
    "model": "string",
    "organization": "string",
    "params": {
      "max_length": 0,
      "max_tokens": 0,
      "min_length": 0,
      "repetition_penalty": 0,
      "seed": 0,
      "stop_words": [
        "string"
      ],
      "temperature": 0,
      "top_k": 0,
      "top_p": 0
    },
    "provider": "string",
    "resource": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Delete model

Delete a model configuration. Returns conflict when referenced.

DELETE
/models/{model_id}

Path Parameters

model_idstring

Model ID

Query Parameters

project?string

Project override

Response Body

curl -X DELETE "https://loading/api/v0/models/string?project=string"
"string"
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}