---
title: "Put Decisions Route"
method: PUT
path: "/api/v1/catalog/decisions"
---

# Put Decisions Route

`PUT /api/v1/catalog/decisions`

## Request

- Base URL: `https://api.stacktrace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stacktrace.ai/api/v1/catalog/decisions`
- Auth: none declared

## Headers

- `authorization` string, nullable

## Request body

- CatalogDecisionsRequest
  - `decisions` CatalogDecisionRequest[], required
    - `component_type` 'mcp' | 'plugin', required
    - `target` object, required
    - `outcome` 'allowed' | 'blocked', required
    - `source` 'review' | 'manual', required
    - `name` string, nullable
    - `note` string, nullable

## Response `200`

Successful Response

- CatalogDecisionsResponse
  - `revision` integer, required
  - `decisions` CatalogRow[], required
    - `key` string, required
    - `component_type` 'mcp' | 'plugin' | 'skill', required
    - `name` string, required
    - `target` object, nullable, required
    - `unavailable` 'not_an_mcp_server' | 'no_identity' | 'not_in_current_bom' | 'controlled_by_plugin' | 'no_exact_target' | 'ambiguous' | 'may_carry_credential' | 'unidentified_service', nullable
    - `reach` integer, required
    - `agent_kinds` string[], required
    - `versions` CatalogVersion[], required
      - `version` string, nullable, required
      - `agent_count` integer, required
    - `version_count` integer, required
    - `identities` string[], required
    - `first_seen_at` string, date-time, nullable, required
    - `vulnerability_counts` SeverityCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `posture_counts` SeverityCounts, required
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `open_detections` integer
    - `decision` CatalogDecisionView
      - `id` string, required
      - `outcome` 'allowed' | 'blocked', required
      - `source` 'review' | 'manual', required
      - `note` string, nullable, required
      - `decided_by` string, required
      - `decided_by_name` string, nullable
      - `decided_at` string, date-time, required
    - `marketplace_decision` CatalogMarketplaceDecision
      - `id` string, required
      - `outcome` 'allowed' | 'blocked', required
      - `source` 'review' | 'manual', required
      - `note` string, nullable, required
      - `decided_by` string, required
      - `decided_by_name` string, nullable
      - `decided_at` string, date-time, required
      - `key` string, required
      - `name` string, required
      - `source_url` string, required
    - `by_default` 'allowed' | 'blocked', nullable
    - `observation_scope_label` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api.md) - [All operations](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stacktrace/apis/stacktrace-fleet-api/revisions/0ee5484d1d0b?raw)