Organization models

Read your organization\u2019s model inventory, including pending and disabled models.

GET /v1/org/models

Authorization

Authorizationheader · string

Bearer $BOARDWALK_API_KEY. Requires models:read.

Request

curl "https://api.boardwalk.cloud/v1/org/models?limit=50" \
  -H "Authorization: Bearer $BOARDWALK_API_KEY"

Query parameters

cursorstringoptional

Opaque next_cursor from the previous page, at most 256 characters. Keep all other filters unchanged.

limitintegeroptional

Page size from 1 to 200. Default: 50.

statusstringoptional

pending, active, or disabled.

visibilitystringoptional

public or private.

qstringoptional

Model search text, at most 120 characters.

Response

Example response. IDs, token counts, and rates are illustrative.

{
  "object": "list",
  "data": [
    {
      "id": "mdl_example",
      "object": "org_model",
      "slug": "support-agent",
      "display_name": "Support agent",
      "status": "pending",
      "visibility": "private",
      "hf_repo": "your-org/support-agent",
      "hf_revision": "0123456789abcdef0123456789abcdef01234567",
      "created_at": "2026-09-16T00:00:00.000Z",
      "updated_at": "2026-09-16T00:00:00.000Z",
      "revision": null
    }
  ],
  "next_cursor": null
}

object"list"

Object type.

dataobject[]

Records ordered newest first.

Child fields

idstring

Internal model ID. Use this in organization detail paths.

object"org_model"

Object type.

slugstring

Callable model ID for inference.

display_namestring

Display name.

statusstring

pending, active, or disabled.

visibilitystring

public or private.

hf_repostring

Source repository.

hf_revisionstring

Weight revision.

created_atstring

ISO 8601 creation time.

updated_atstring

ISO 8601 last update time.

revisionobject | null

Serving configuration, when available.

Child fields

idstring

Configuration revision ID.

statusstring

draft, active, or superseded.

hf_revisionstring

Pinned weight commit.

dtypestring

Serving precision.

quantizationstring

Quantization method, or none.

max_model_leninteger

Combined input and output token limit.

enginestring

Serving engine.

engine_versionstring

Pinned engine version.

gpu_poolstring

GPU pool for the configuration.

gpu_countinteger

GPUs in the configuration.

pricesobject

Rates for this configuration. Draft prices are not active rates.

Child fields

input_micros_per_mtokstring

Input rate. Integer micro-dollars per million tokens.

output_micros_per_mtokstring

Output rate. Integer micro-dollars per million tokens.

cache_read_micros_per_mtokstring

Cache-read rate. Integer micro-dollars per million tokens.

cache_write_micros_per_mtokstring

Cache-write rate. Integer micro-dollars per million tokens.

verified_atstring | null

Qualification time, in ISO 8601 format.

next_cursorstring | null

Pass as cursor for the next page. Null marks the end.

Retrieve one record

GET /v1/org/models/{id} returns one object directly, without the list envelope. It accepts no query parameters.

idpath · stringrequired

Record ID from a list response.

curl https://api.boardwalk.cloud/v1/org/models/mdl_example \
  -H "Authorization: Bearer $BOARDWALK_API_KEY"

{
  "id": "mdl_example",
  "object": "org_model",
  "slug": "support-agent",
  "display_name": "Support agent",
  "status": "pending",
  "visibility": "private",
  "hf_repo": "your-org/support-agent",
  "hf_revision": "0123456789abcdef0123456789abcdef01234567",
  "created_at": "2026-09-16T00:00:00.000Z",
  "updated_at": "2026-09-16T00:00:00.000Z",
  "revision": null
}

Detail fields match the object in data above.

Errors

Errors use the shared error format. Save the x-request-id response header for receipts and support.