---
title: "Update Adaptive Card"
method: PUT
path: "/team-messaging/v1/adaptive-cards/{cardId}"
tags: ["Adaptive Cards"]
---

# Update Adaptive Card

`PUT /team-messaging/v1/adaptive-cards/{cardId}`

Updates an adaptive card.

## Path parameters

- `cardId` string, required

## Request body

- AdaptiveCardRequest
  - `type` 'AdaptiveCard', required — Type of attachment. This field is mandatory and filled on server side - will be ignored if set in request body
  - `version` string, required — Version. This field is mandatory and filled on server side - will be ignored if set in request body
  - `body` AdaptiveCardInfoRequest[] — List of adaptive cards with the detailed information
    - `type` 'Container'
    - `items` AdaptiveCardInfoRequestItem[]
      - `type` 'TextBlock' | 'ColumnSet' | 'Column' | 'FactSet'
      - `text` string
      - `weight` string
      - `size` string
      - `columns` AdaptiveCardColumnInfo[]
        - `type` string
        - `width` string
        - `items` AdaptiveCardColumnItemInfo[]
          - `type` string
          - `url` string, uri
          - `size` string
          - `style` string
          - `wrap` boolean
          - `spacing` string
          - `text` string
          - `isSubtle` boolean
  - `actions` AdaptiveCardAction[]
    - `type` 'Action.ShowCard' | 'Action.Submit' | 'Action.OpenUrl' | 'Action.ToggleVisibility'
    - `title` string
    - `card` ActionAdaptiveCardInfo
      - `type` 'AdaptiveCard'
      - `body` ActionCardBody[]
        - `type` 'Input.Text'
        - `id` string
        - `isMultiline` boolean — If set to `true`, allows multiple lines of input
        - `placeholder` string — Description of the input desired. Displayed when no text has been input
    - `url` string, uri
  - `selectAction` AdaptiveCardSelectAction — An action that will be invoked when the card is tapped or selected. `Action.ShowCard` is not supported
    - `type` 'Action.Submit' | 'Action.OpenUrl' | 'Action.ToggleVisibility', required
  - `fallbackText` string
  - `backgroundImage` union — Specifies the background image of a card
    - string
    - BackgroundImage — Specifies a background image oa a card. Acceptable formats are PNG, JPEG, and GIF
      - `type` 'BackgroundImage' — Must be `BackgroundImage`
      - `url` string, uri, required — The URL/data URL of an image to be used as a background of a card. Acceptable formats are PNG, JPEG, and GIF
      - `fillMode` union — Describes how the image should fill the area
        - 'cover' | 'repeatHorizontally' | 'repeatVertically' | 'repeat'
        - string
      - `horizontalAlignment` union — Describes how the image should be aligned if it must be cropped or if using repeat fill mode
        - 'left' | 'center' | 'right'
        - string
      - `verticalAlignment` union — Describes how the image should be aligned if it must be cropped or if using repeat fill mode
        - 'top' | 'center' | 'bottom'
        - string
  - `minHeight` string — Specifies the minimum height of the card in pixels
  - `speak` string — Specifies what should be spoken for this entire card. This is simple text or SSML fragment
  - `lang` 'en' | 'fr' | 'es' — The 2-letter ISO-639-1 language used in the card. Used to localize any date/time functions
  - `verticalContentAlignment` union — Defines how the content should be aligned vertically within the container. Only relevant for fixed-height cards, or cards with a `minHeight` specified
    - 'top' | 'center' | 'bottom'
    - string

## Response `200`

OK

- AdaptiveCardShortInfo
  - `id` string — Internal identifier of an adaptive card
  - `creationTime` string, date-time — Adaptive Card creation datetime in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `lastModifiedTime` string, date-time — Post last modification datetime in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format
  - `$schema` string — Schema of an adaptive card
  - `type` 'AdaptiveCard'
  - `version` string — Version of an adaptive card. Filled on server-side
  - `creator` AdaptiveCardCreator
    - `id` string — Internal identifier of a creator
  - `chatIds` string[] — Chat IDs where an adaptive card is posted or shared.

## Other responses

- `400` — Some of the parameters are missing or have invalid format
- `403` — You do not have permissions to update specified adaptive card.
- `404` — Adaptive Card for update does not exist.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)