---
title: "Preview Catalog Operations"
method: GET
path: "/catalog/{api_id}/operations"
tags: ["Catalog"]
---

# Preview Catalog Operations

`GET /catalog/{api_id}/operations`

Preview the operations of a catalog entry's spec (capped, offset-paginated).

``tag`` and ``q`` filter the spec's operations server-side before windowing,
so the UI's search box covers every operation in the spec and pages the
filtered set via ``offset``/``limit`` ("Load more").

## Path parameters

- `api_id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `tag` string, nullable
- `q` string, nullable

## Response `200`

Successful Response

- OperationPreviewListResponse — Capped, offset-paginated operation preview for a catalog entry. Unlike list endpoints (cursor-paginated), the preview uses simple offset/limit pagination deliberately: it reads a single, already-fetched spec document and is hard-capped at ``PREVIEW_MAX_OPERATIONS`` operations, so there is no large/mutating result set that would justify keyset cursors.
  - `data` PreviewOperationResponse[], required — The page of previewed operations.
    - `description` string, required — Operation description (empty string when absent).
    - `method` string, required — Upper-case HTTP method.
    - `operation_id` string, nullable, required — OpenAPI operationId, when declared.
    - `parameters` PreviewParameterResponse[], required — Merged path- and operation-level parameters.
      - `description` string, required — Parameter description (empty string when absent).
      - `in` string, required — OpenAPI parameter location.
      - `name` string, required — Parameter name.
      - `required` boolean, required — Whether the parameter is required.
    - `path` string, required — Operation path template.
    - `security` string[], required — Flattened names of the security schemes that apply.
    - `summary` string, required — Operation summary (empty string when absent).
    - `tags` string[], required — Operation tags.
  - `info` PreviewInfoResponse, required — The `info` block fields surfaced in a preview.
    - `description` string, nullable, required — Spec description.
    - `title` string, nullable, required — Spec title.
    - `version` string, nullable, required — Spec version.
  - `offset` integer, required — Offset of the returned window.
  - `security_schemes` object, required — Slimmed `components.securitySchemes` projection.
  - `total` integer, required — Total operations in the spec (pre-page).
  - `truncated` boolean, required — Whether more operations follow this window.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.net/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jentic/jentic-control-plane-api/versions/ff371f19960a/schema)