---
title: "Update a scorecard"
method: PATCH
path: "/scorecards/{scorecardId}"
tags: ["Catalog"]
---

# Update a scorecard

`PATCH /scorecards/{scorecardId}`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/scorecards/{scorecardId}`
- Auth: HTTP bearer

## Request body

- ScorecardInput
  - `name` string, required
  - `description` string, nullable
  - `applicableKinds` string[], required
  - `rules` ScorecardRule[], required
    - `id` string, required
    - `type` 'has_owner_team' | 'has_description' | 'lifecycle_in', required
    - `label` string, required
    - `description` string, nullable
    - `weight` integer, required
    - `params` object
  - `tiers` ScorecardTier[]
    - `name` string, required: Lowercase identifier — e.g. bronze / silver / gold.
    - `minScore` integer, required
  - `tags` string[]
  - `scopeTeamId` string, nullable: Optional: only grade entities owned by this team.
  - `scopeTags` string[]: Optional: only grade entities with at least one of these tags.
  - `scopeSystemId` string, nullable: Optional: only grade entities belonging to this System.
  - `scopeDomainId` string, nullable: Optional: only grade entities belonging to this Domain.

## Response `200`

Updated

- object
  - `scorecard` Scorecard: An admin-defined bundle of rules that scores catalog entities and assigns them a tier.
    - `id` string, required
    - `name` string, required
    - `description` string, nullable
    - `applicableKinds` string[], required
    - `rules` ScorecardRule[], required
      - `id` string, required
      - `type` 'has_owner_team' | 'has_description' | 'lifecycle_in', required
      - `label` string, required
      - `description` string, nullable
      - `weight` integer, required
      - `params` object
    - `tiers` ScorecardTier[], required
      - `name` string, required: Lowercase identifier — e.g. bronze / silver / gold.
      - `minScore` integer, required
    - `tags` string[]
    - `scopeTeamId` string, nullable: If set, only grades entities owned by this team.
    - `scopeTags` string[]: If non-empty, only grades entities carrying at least one of these tags.
    - `scopeSystemId` string, nullable: If set, only grades entities belonging to this System.
    - `scopeDomainId` string, nullable: If set, only grades entities belonging to this Domain.
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `403` (unresolved $ref)
- `404` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)