---
title: "PUT /api/card/{id}"
method: PUT
path: "/api/card/{id}"
tags: ["/api/card"]
---

# PUT /api/card/{id}

`PUT /api/card/{id}`

Update a `Card`.

## Path parameters

- `id` integer, required

## Query parameters

- `delete_old_dashcards` boolean, nullable

## Request body

- object
  - `archived` boolean, nullable
  - `cache_ttl` integer, nullable — value must be an integer greater than zero.
  - `collection_id` integer, nullable — value must be an integer greater than zero.
  - `collection_position` integer, nullable — value must be an integer greater than zero.
  - `collection_preview` boolean, nullable
  - `dashboard_id` integer, nullable — value must be an integer greater than zero.
  - `dashboard_tab_id` integer, nullable — value must be an integer greater than zero.
  - `dataset_query` object, nullable — Value must be a map.
  - `description` string, nullable
  - `display` string, nullable
  - `embedding_params` object, nullable
  - `embedding_type` string, nullable
  - `enable_embedding` boolean, nullable
  - `name` string, nullable
  - `parameter_mappings` MetabaseParametersSchemaParameterMapping[]
    - `card_id` integer — Valid Card ID
    - `dashcard` object
    - `parameter_id` string, required
    - `target` union, required
      - unknown
      - unknown[]
        - unknown
      - unknown[] — A :text-tag parameter :target applies to parameterized text cards in viz settings
        - unknown
      - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
  - `parameters` MetabaseParametersSchemaParameter[]
    - `default` unknown
    - `filteringParameters` MetabaseLibSchemaParameterId[], nullable
    - `id` string, required
    - `mappings` union
      - MetabaseParametersSchemaParameterMapping[]
        - `card_id` integer — Valid Card ID
        - `dashcard` object
        - `parameter_id` string, required
        - `target` union, required
          - unknown
          - unknown[]
            - unknown
          - unknown[] — A :text-tag parameter :target applies to parameterized text cards in viz settings
            - unknown
          - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
      - MetabaseParametersSchemaParameterMapping[]
        - `card_id` integer — Valid Card ID
        - `dashcard` object
        - `parameter_id` string, required
        - `target` union, required
          - unknown
          - unknown[]
            - unknown
          - unknown[] — A :text-tag parameter :target applies to parameterized text cards in viz settings
            - unknown
          - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
    - `name` string
    - `sectionId` string
    - `slug` string
    - `target` union
      - unknown
      - unknown[]
        - unknown
      - unknown[] — A :text-tag parameter :target applies to parameterized text cards in viz settings
        - unknown
      - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
    - `temporal_units` MetabaseLibSchemaTemporalBucketingUnit[], nullable
    - `type` 'number' | 'text' | 'date' | 'boolean' | 'date/single' | 'id' | 'category' | 'location/city' | 'location/state' | 'location/zip_code' | 'location/country' | 'date/range' | 'date/month-year' | 'date/quarter-year' | 'date/relative' | 'date/all-options' | 'temporal-unit' | 'number/!=' | 'number/<=' | 'number/=' | 'number/>=' | 'number/between' | 'string/!=' | 'string/=' | 'string/contains' | 'string/does-not-contain' | 'string/ends-with' | 'string/starts-with' | 'boolean/=', required — Valid parameter :type
    - `values_query_type` 'none' | 'list' | 'search'
    - `values_source_config` MetabaseParametersSchemaValuesSourceConfig — Schema for valid source_options within a Parameter
      - `card_id` integer — Valid Card ID
      - `label_field` union
        - unknown
        - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
      - `value_field` union
        - unknown
        - MetabaseLibSchemaParameterTargetLegacyFieldRef — unresolved $ref
      - `values` unknown
    - `values_source_type` 'static-list' | 'card'
  - `result_metadata` MetabaseQueryProcessorSchemaResultMetadataColumn[], nullable — value must be an array of valid results column metadata maps. — unresolved $ref
  - `type` 'question' | 'metric' | 'model' — All acceptable card types. Previously (< 49), we only had 2 card types: question and model, which were differentiated using the boolean `dataset` column. Soon we'll have more card types (e.g: metric) and we will longer be able to use a boolean column to differentiate between all types. So we've added a new `type` column for this purpose. Migrating all the code to use `report_card.type` will be quite an effort, we decided that we'll migrate it gradually.
  - `visualization_settings` object, nullable — Value must be a map.

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) · [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/metabase/metabase-api/revisions/e879e0319b12/schema)