Schema URL https://catalog.lintel.tools/schemas/schemastore/ui5-manifest/_shared/latest--adaptive-card.json
Parent schema ui5-manifest

Any of

1. variant

Definitions

Action.Execute object

Gathers input fields, merges with optional data field, and sends an event to the client. Clients process the event by sending an Invoke activity of type adaptiveCard/action to the target Bot. The inputs that are gathered are those on the current card, and in the case of a show card those on any parent cards. See Universal Action Model documentation for more details.

type enum

Must be Action.Execute

Values: "Action.Execute"
verb string

The card author-defined verb associated with this action.

data string | object

Initial data that input fields will be combined with. These are essentially ‘hidden’ properties.

associatedInputs enum
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
Action.OpenUrl object

When invoked, show the given url either by launching it in an external web browser or showing within an embedded web browser.

url string required

The URL to open.

format=uri-reference
type enum

Must be Action.OpenUrl

Values: "Action.OpenUrl"
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
Action.ShowCard object

Defines an AdaptiveCard which is shown to the user when the button or link is clicked.

type enum

Must be Action.ShowCard

Values: "Action.ShowCard"
card object

An Adaptive Card, containing a free-form body of card elements, and an optional set of actions.

15 nested properties
type enum

Must be AdaptiveCard

Values: "AdaptiveCard"
version string

Schema version that this card requires. If a client is lower than this version, the fallbackText will be rendered. NOTE: Version is not required for cards within an Action.ShowCard. However, it is required for the top-level card.

Examples: "1.0", "1.1", "1.2"
refresh object

Defines how a card can be refreshed by making a request to the target Bot.

3 nested properties
type enum

Must be Refresh

Values: "Refresh"
action object

Gathers input fields, merges with optional data field, and sends an event to the client. Clients process the event by sending an Invoke activity of type adaptiveCard/action to the target Bot. The inputs that are gathered are those on the current card, and in the case of a show card those on any parent cards. See Universal Action Model documentation for more details.

All of: Extendable.Action object
userIds string[]

A list of user Ids informing the client for which users should the refresh action should be run automatically. Some clients will not run the refresh action automatically unless this property is specified. Some clients may ignore this property and always run the refresh action automatically.

authentication object

Defines authentication information associated with a card. This maps to the OAuthCard type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.oauthcard)

5 nested properties
type enum

Must be Authentication

Values: "Authentication"
text string

Text that can be displayed to the end user when prompting them to authenticate.

connectionName string

The identifier for registered OAuth connection setting information.

tokenExchangeResource object

Defines information required to enable on-behalf-of single sign-on user authentication. Maps to the TokenExchangeResource type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.tokenexchangeresource)

Buttons that should be displayed to the user when prompting for authentication. The array MUST contain one button of type "signin". Other button types are not currently supported.

The card elements to show in the primary card region.

The Actions to show in the card's action bar.

selectAction
fallbackText string

Text shown when the client doesn't support the version specified (may contain markdown).

backgroundImage BackgroundImage | string

Specifies the background image of the card.

minHeight string

Specifies the minimum height of the card.

Examples: "50px"
rtl boolean | null

When true content in this Adaptive Card should be presented right to left. When 'false' content in this Adaptive Card should be presented left to right. If unset, the default platform behavior will apply.

speak string

Specifies what should be spoken for this entire card. This is simple text or SSML fragment.

lang string

The 2-letter ISO-639-1 language used in the card. Used to localize any date/time functions.

Examples: "en", "fr", "es"
verticalContentAlignment enum
$schema string

The Adaptive Card schema.

format=uri
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
Action.Submit object

Gathers input fields, merges with optional data field, and sends an event to the client. It is up to the client to determine how this data is processed. For example: With BotFramework bots, the client would send an activity through the messaging medium to the bot. The inputs that are gathered are those on the current card, and in the case of a show card those on any parent cards. See https://docs.microsoft.com/en-us/adaptive-cards/authoring-cards/input-validation for more details.

type enum

Must be Action.Submit

Values: "Action.Submit"
data string | object

Initial data that input fields will be combined with. These are essentially ‘hidden’ properties.

associatedInputs enum
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
Action.ToggleVisibility object

An action that toggles the visibility of associated card elements.

targetElements TargetElement[] required

The array of TargetElements. It is not recommended to include Input elements with validation under Action.Toggle due to confusion that can arise from invalid inputs that are not currently visible. See https://docs.microsoft.com/en-us/adaptive-cards/authoring-cards/input-validation for more information.

type enum

Must be Action.ToggleVisibility

Values: "Action.ToggleVisibility"
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
TargetElement string | object

Represents an entry for Action.ToggleVisibility's targetElements property

AdaptiveCard object

An Adaptive Card, containing a free-form body of card elements, and an optional set of actions.

type enum

Must be AdaptiveCard

Values: "AdaptiveCard"
version string

Schema version that this card requires. If a client is lower than this version, the fallbackText will be rendered. NOTE: Version is not required for cards within an Action.ShowCard. However, it is required for the top-level card.

Examples: "1.0", "1.1", "1.2"
refresh object

Defines how a card can be refreshed by making a request to the target Bot.

3 nested properties
type enum

Must be Refresh

Values: "Refresh"
action object

Gathers input fields, merges with optional data field, and sends an event to the client. Clients process the event by sending an Invoke activity of type adaptiveCard/action to the target Bot. The inputs that are gathered are those on the current card, and in the case of a show card those on any parent cards. See Universal Action Model documentation for more details.

All of: Extendable.Action object
13 nested properties
type enum

Must be Action.Execute

Values: "Action.Execute"
verb string

The card author-defined verb associated with this action.

data string | object

Initial data that input fields will be combined with. These are essentially ‘hidden’ properties.

associatedInputs enum
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
userIds string[]

A list of user Ids informing the client for which users should the refresh action should be run automatically. Some clients will not run the refresh action automatically unless this property is specified. Some clients may ignore this property and always run the refresh action automatically.

authentication object

Defines authentication information associated with a card. This maps to the OAuthCard type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.oauthcard)

5 nested properties
type enum

Must be Authentication

Values: "Authentication"
text string

Text that can be displayed to the end user when prompting them to authenticate.

connectionName string

The identifier for registered OAuth connection setting information.

tokenExchangeResource object

Defines information required to enable on-behalf-of single sign-on user authentication. Maps to the TokenExchangeResource type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.tokenexchangeresource)

4 nested properties
id string required

The unique identified of this token exchange instance.

uri string required

An application ID or resource identifier with which to exchange a token on behalf of. This property is identity provider- and application-specific.

providerId string required

An identifier for the identity provider with which to attempt a token exchange.

type enum

Must be TokenExchangeResource

Values: "TokenExchangeResource"

Buttons that should be displayed to the user when prompting for authentication. The array MUST contain one button of type "signin". Other button types are not currently supported.

The card elements to show in the primary card region.

The Actions to show in the card's action bar.

selectAction
fallbackText string

Text shown when the client doesn't support the version specified (may contain markdown).

backgroundImage BackgroundImage | string

Specifies the background image of the card.

minHeight string

Specifies the minimum height of the card.

Examples: "50px"
rtl boolean | null

When true content in this Adaptive Card should be presented right to left. When 'false' content in this Adaptive Card should be presented left to right. If unset, the default platform behavior will apply.

speak string

Specifies what should be spoken for this entire card. This is simple text or SSML fragment.

lang string

The 2-letter ISO-639-1 language used in the card. Used to localize any date/time functions.

Examples: "en", "fr", "es"
verticalContentAlignment enum
$schema string

The Adaptive Card schema.

format=uri
ActionSet object

Displays a set of actions.

actions ImplementationsOf.Action[] required

The array of Action elements to show.

type enum

Must be ActionSet

Values: "ActionSet"
fallback
height
separator
spacing
id
isVisible
requires
Column object

Defines a container that is part of a ColumnSet.

type enum

Must be Column

Values: "Column"

The card elements to render inside the Column.

backgroundImage BackgroundImage | string

Specifies the background image. Acceptable formats are PNG, JPEG, and GIF

bleed boolean

Determines whether the column should bleed through its parent's padding.

fallback Column | FallbackOption

Describes what to do when an unknown item is encountered or the requires of this or any children can't be met.

minHeight string

Specifies the minimum height of the column in pixels, like "80px".

Examples: "50px"
rtl boolean | null

When true content in this column should be presented right to left. When 'false' content in this column should be presented left to right. When unset layout direction will inherit from parent container or column. If unset in all ancestors, the default platform behavior will apply.

separator boolean

When true, draw a separating line between this column and the previous column.

spacing enum

Specifies how much spacing. Hosts pick the exact pixel amounts for each of these.

selectAction
style ContainerStyle | null

Style hint for Column.

verticalContentAlignment VerticalContentAlignment | null

Defines how the content should be aligned vertically within the column. When not specified, the value of verticalContentAlignment is inherited from the parent container. If no parent container has verticalContentAlignment set, it defaults to Top.

width string | number

"auto", "stretch", a number representing relative width of the column in the column group, or in version 1.1 and higher, a specific pixel width, like "50px".

id
isVisible
requires
ColumnSet object

ColumnSet divides a region into Columns, allowing elements to sit side-by-side.

type enum

Must be ColumnSet

Values: "ColumnSet"
columns Column[]

The array of Columns to divide the region into.

selectAction
style ContainerStyle | null

Style hint for ColumnSet.

bleed boolean

Determines whether the element should bleed through its parent's padding.

minHeight string

Specifies the minimum height of the column set in pixels, like "80px".

Examples: "50px"
horizontalAlignment HorizontalAlignment | null

Controls the horizontal alignment of the ColumnSet. When not specified, the value of horizontalAlignment is inherited from the parent container. If no parent container has horizontalAlignment set, it defaults to Left.

fallback
height
separator
spacing
id
isVisible
requires
Container object

Containers group items together.

The card elements to render inside the Container.

type enum

Must be Container

Values: "Container"
selectAction
style ContainerStyle | null

Style hint for Container.

verticalContentAlignment VerticalContentAlignment | null

Defines how the content should be aligned vertically within the container. When not specified, the value of verticalContentAlignment is inherited from the parent container. If no parent container has verticalContentAlignment set, it defaults to Top.

bleed boolean

Determines whether the element should bleed through its parent's padding.

backgroundImage BackgroundImage | string

Specifies the background image. Acceptable formats are PNG, JPEG, and GIF

minHeight string

Specifies the minimum height of the container in pixels, like "80px".

Examples: "50px"
rtl? boolean | null

When true content in this container should be presented right to left. When 'false' content in this container should be presented left to right. When unset layout direction will inherit from parent container or column. If unset in all ancestors, the default platform behavior will apply.

fallback
height
separator
spacing
id
isVisible
requires
Fact object

Describes a Fact in a FactSet as a key/value pair.

title string required

The title of the fact.

value string required

The value of the fact.

type enum

Must be Fact

Values: "Fact"
FactSet object

The FactSet element displays a series of facts (i.e. name/value pairs) in a tabular form.

facts Fact[] required

The array of Fact's.

type enum

Must be FactSet

Values: "FactSet"
fallback
height
separator
spacing
id
isVisible
requires
Image object

Displays an image. Acceptable formats are PNG, JPEG, and GIF

url string required

The URL to the image. Supports data URI in version 1.2+

format=uri-reference
type enum

Must be Image

Values: "Image"
altText string

Alternate text describing the image.

backgroundColor string

Applies a background to a transparent image. This property will respect the image style.

height string | BlockElementHeight

The desired height of the image. If specified as a pixel value, ending in 'px', E.g., 50px, the image will distort to fit that exact height. This overrides the size property.

Default: "auto"
Examples: "50px"
horizontalAlignment HorizontalAlignment | null

Controls how this element is horizontally positioned within its parent. When not specified, the value of horizontalAlignment is inherited from the parent container. If no parent container has horizontalAlignment set, it defaults to Left.

selectAction
size enum

Controls the approximate size of the image. The physical dimensions will vary per host. Every option preserves aspect ratio.

style enum

Controls how this Image is displayed.

width string

The desired on-screen width of the image, ending in 'px'. E.g., 50px. This overrides the size property.

Examples: "50px"

Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.

separator boolean

When true, draw a separating line at the top of the element.

spacing enum

Specifies how much spacing. Hosts pick the exact pixel amounts for each of these.

id string

A unique identifier associated with the item.

isVisible boolean

If false, this item will be removed from the visual tree.

Default: true
requires Record<string, string>

A series of key/value pairs indicating features that the item requires with corresponding minimum version. When a feature is missing or of insufficient version, fallback is triggered.

ImageSet object

The ImageSet displays a collection of Images similar to a gallery. Acceptable formats are PNG, JPEG, and GIF

images Image[] required

The array of Image elements to show.

type enum

Must be ImageSet

Values: "ImageSet"
imageSize enum

Controls the approximate size of the image. The physical dimensions will vary per host. Every option preserves aspect ratio.

fallback
height
separator
spacing
id
isVisible
requires
TextRun string | object

Defines a single run of formatted text. A TextRun with no properties set can be represented in the json as string containing the text as a shorthand for the json object. These two representations are equivalent.

Input.Choice object

Describes a choice for use in a ChoiceSet.

title string required

Text to display.

value string required

The raw value for the choice. NOTE: do not use a , in the value, since a ChoiceSet with isMultiSelect set to true returns a comma-delimited string of choice values.

type enum

Must be Input.Choice

Values: "Input.Choice"
Input.ChoiceSet object

Allows a user to input a Choice.

type enum

Must be Input.ChoiceSet

Values: "Input.ChoiceSet"
choices Input.Choice[]

Choice options.

isMultiSelect boolean

Allow multiple choices to be selected.

Default: false
style enum

Style hint for Input.ChoiceSet.

value string

The initial choice (or set of choices) that should be selected. For multi-select, specify a comma-separated string of values.

placeholder string

Description of the input desired. Only visible when no selection has been made, the style is compact and isMultiSelect is false

wrap boolean

If true, allow text to wrap. Otherwise, text is clipped.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Input.Date object

Lets a user choose a date.

type enum

Must be Input.Date

Values: "Input.Date"
max string

Hint of maximum value expressed in YYYY-MM-DD(may be ignored by some clients).

min string

Hint of minimum value expressed in YYYY-MM-DD(may be ignored by some clients).

placeholder string

Description of the input desired. Displayed when no selection has been made.

value string

The initial value for this field expressed in YYYY-MM-DD.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Input.Number object

Allows a user to enter a number.

type enum

Must be Input.Number

Values: "Input.Number"
max number

Hint of maximum value (may be ignored by some clients).

min number

Hint of minimum value (may be ignored by some clients).

placeholder string

Description of the input desired. Displayed when no selection has been made.

value number

Initial value for this field.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Input.Text object

Lets a user enter text.

type enum

Must be Input.Text

Values: "Input.Text"
isMultiline boolean

If true, allow multiple lines of input.

Default: false
maxLength number

Hint of maximum length characters to collect (may be ignored by some clients).

placeholder string

Description of the input desired. Displayed when no text has been input.

regex string

Regular expression indicating the required format of this text input.

style enum

Style hint for text input.

inlineAction
value string

The initial value for this field.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Input.Time object

Lets a user select a time.

type enum

Must be Input.Time

Values: "Input.Time"
max string

Hint of maximum value expressed in HH:MM (may be ignored by some clients).

min string

Hint of minimum value expressed in HH:MM (may be ignored by some clients).

placeholder string

Description of the input desired. Displayed when no time has been selected.

value string

The initial value for this field expressed in HH:MM.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Input.Toggle object

Lets a user choose between two options.

title string required

Title for the toggle

type enum

Must be Input.Toggle

Values: "Input.Toggle"
value string

The initial selected value. If you want the toggle to be initially on, set this to the value of valueOn's value.

Default: "false"
valueOff string

The value when toggle is off

Default: "false"
valueOn string

The value when toggle is on

Default: "true"
wrap boolean

If true, allow text to wrap. Otherwise, text is clipped.

id
errorMessage
isRequired
label
fallback
height
separator
spacing
isVisible
requires
Media object

Displays a media player for audio or video content.

sources MediaSource[] required

Array of media sources to attempt to play.

type enum

Must be Media

Values: "Media"
poster string

URL of an image to display before playing. Supports data URI in version 1.2+

format=uri-reference
altText string

Alternate text describing the audio or video.

fallback
height
separator
spacing
id
isVisible
requires
MediaSource object

Defines a source for a Media element

mimeType string required

Mime type of associated media (e.g. "video/mp4").

url string required

URL to media. Supports data URI in version 1.2+

format=uri-reference
type enum

Must be MediaSource

Values: "MediaSource"
RichTextBlock object

Defines an array of inlines, allowing for inline text formatting.

inlines ImplementationsOf.Inline[] required

The array of inlines.

type enum

Must be RichTextBlock

Values: "RichTextBlock"
horizontalAlignment HorizontalAlignment | null

Controls the horizontal text alignment. When not specified, the value of horizontalAlignment is inherited from the parent container. If no parent container has horizontalAlignment set, it defaults to Left.

fallback
height
separator
spacing
id
isVisible
requires
Table object

Provides a way to display data in a tabular form.

type enum

Must be Table

Values: "Table"

Defines the number of columns in the table, their sizes, and more.

rows TableRow[]

Defines the rows of the table.

firstRowAsHeader boolean

Specifies whether the first row of the table should be treated as a header row, and be announced as such by accessibility software.

Default: true
showGridLines boolean

Specifies whether grid lines should be displayed.

Default: true
gridStyle ContainerStyle | null

Defines the style of the grid. This property currently only controls the grid's color.

Default: "default"
horizontalCellContentAlignment HorizontalAlignment | null

Controls how the content of all cells is horizontally aligned by default. When not specified, horizontal alignment is defined on a per-cell basis.

verticalCellContentAlignment VerticalAlignment | null

Controls how the content of all cells is vertically aligned by default. When not specified, vertical alignment is defined on a per-cell basis.

fallback
height
separator
spacing
id
isVisible
requires
TableCell object

Represents a cell within a row of a Table element.

The card elements to render inside the TableCell.

type enum

Must be TableCell

Values: "TableCell"
selectAction
style ContainerStyle | null

Style hint for TableCell.

verticalContentAlignment VerticalContentAlignment | null

Defines how the content should be aligned vertically within the container. When not specified, the value of verticalContentAlignment is inherited from the parent container. If no parent container has verticalContentAlignment set, it defaults to Top.

bleed boolean

Determines whether the element should bleed through its parent's padding.

backgroundImage BackgroundImage | string

Specifies the background image. Acceptable formats are PNG, JPEG, and GIF

minHeight string

Specifies the minimum height of the container in pixels, like "80px".

Examples: "50px"
rtl? boolean | null

When true content in this container should be presented right to left. When 'false' content in this container should be presented left to right. When unset layout direction will inherit from parent container or column. If unset in all ancestors, the default platform behavior will apply.

TableColumnDefinition object

Defines the characteristics of a column in a Table element.

type enum

Must be TableColumnDefinition

Values: "TableColumnDefinition"
width string | number

Specifies the width of the column. If expressed as a number, width represents the weight a the column relative to the other columns in the table. If expressed as a string, width must by in the format "px" (for instance, "50px") and represents an explicit number of pixels.

Default: 1
horizontalCellContentAlignment HorizontalAlignment | null

Controls how the content of all cells in the column is horizontally aligned by default. When specified, this value overrides the setting at the table level. When not specified, horizontal alignment is defined at the table, row or cell level.

verticalCellContentAlignment VerticalAlignment | null

Controls how the content of all cells in the column is vertically aligned by default. When specified, this value overrides the setting at the table level. When not specified, vertical alignment is defined at the table, row or cell level.

TableRow object

Represents a row of cells within a Table element.

type enum

Must be TableRow

Values: "TableRow"
cells TableCell[]

The cells in this row. If a row contains more cells than there are columns defined on the Table element, the extra cells are ignored.

style ContainerStyle | null

Defines the style of the entire row.

horizontalCellContentAlignment HorizontalAlignment | null

Controls how the content of all cells in the row is horizontally aligned by default. When specified, this value overrides both the setting at the table and columns level. When not specified, horizontal alignment is defined at the table, column or cell level.

verticalCellContentAlignment VerticalAlignment | null

Controls how the content of all cells in the column is vertically aligned by default. When specified, this value overrides the setting at the table and column level. When not specified, vertical alignment is defined either at the table, column or cell level.

TextBlock object

Displays text, allowing control over font sizes, weight, and color.

text string required

Text to display. A subset of markdown is supported (https://aka.ms/ACTextFeatures)

type enum

Must be TextBlock

Values: "TextBlock"
color Colors | null

Controls the color of TextBlock elements.

fontType FontType | null

Type of font to use for rendering

horizontalAlignment HorizontalAlignment | null

Controls the horizontal text alignment. When not specified, the value of horizontalAlignment is inherited from the parent container. If no parent container has horizontalAlignment set, it defaults to Left.

isSubtle boolean | null

If true, displays text slightly toned down to appear less prominent.

Default: false
maxLines number

Specifies the maximum number of lines to display.

size FontSize | null

Controls size of text.

weight FontWeight | null

Controls the weight of TextBlock elements.

wrap boolean

If true, allow text to wrap. Otherwise, text is clipped.

Default: false
style TextBlockStyle | null

The style of this TextBlock for accessibility purposes.

Default: "default"
fallback
height
separator
spacing
id
isVisible
requires
ActionMode enum

Determines whether an action is displayed with a button or is moved to the overflow menu.

ActionStyle enum

Controls the style of an Action, which influences how the action is displayed, spoken, etc.

AssociatedInputs enum
BlockElementHeight enum
ChoiceInputStyle enum

Style hint for Input.ChoiceSet.

Colors enum
ContainerStyle enum
FallbackOption enum
FontSize enum
FontType enum
FontWeight enum
HorizontalAlignment enum

Controls how content is horizontally positioned within its container.

ImageFillMode enum
ImageSize enum

Controls the approximate size of the image. The physical dimensions will vary per host. Every option preserves aspect ratio.

ImageStyle enum

Controls how this Image is displayed.

Spacing enum

Specifies how much spacing. Hosts pick the exact pixel amounts for each of these.

TextBlockStyle enum

Controls how a TextBlock behaves.

TextInputStyle enum

Style hint for text input.

VerticalAlignment enum
VerticalContentAlignment enum
AuthCardButton object

Defines a button as displayed when prompting a user to authenticate. This maps to the cardAction type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.cardaction).

type string required

The type of the button.

value string required

The value associated with the button. The meaning of value depends on the button's type.

title string

The caption of the button.

image string

A URL to an image to display alongside the button's caption.

Authentication object

Defines authentication information associated with a card. This maps to the OAuthCard type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.oauthcard)

type enum

Must be Authentication

Values: "Authentication"
text string

Text that can be displayed to the end user when prompting them to authenticate.

connectionName string

The identifier for registered OAuth connection setting information.

tokenExchangeResource object

Defines information required to enable on-behalf-of single sign-on user authentication. Maps to the TokenExchangeResource type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.tokenexchangeresource)

4 nested properties
id string required

The unique identified of this token exchange instance.

uri string required

An application ID or resource identifier with which to exchange a token on behalf of. This property is identity provider- and application-specific.

providerId string required

An identifier for the identity provider with which to attempt a token exchange.

type enum

Must be TokenExchangeResource

Values: "TokenExchangeResource"

Buttons that should be displayed to the user when prompting for authentication. The array MUST contain one button of type "signin". Other button types are not currently supported.

BackgroundImage object

Specifies a background image. Acceptable formats are PNG, JPEG, and GIF

url string required

The URL (or data url) of the image. Acceptable formats are PNG, JPEG, and GIF

format=uri-reference
type enum

Must be BackgroundImage

Values: "BackgroundImage"
fillMode enum
horizontalAlignment enum

Controls how content is horizontally positioned within its container.

verticalAlignment enum
Refresh object

Defines how a card can be refreshed by making a request to the target Bot.

type enum

Must be Refresh

Values: "Refresh"
action object

Gathers input fields, merges with optional data field, and sends an event to the client. Clients process the event by sending an Invoke activity of type adaptiveCard/action to the target Bot. The inputs that are gathered are those on the current card, and in the case of a show card those on any parent cards. See Universal Action Model documentation for more details.

All of: Extendable.Action object
13 nested properties
type enum

Must be Action.Execute

Values: "Action.Execute"
verb string

The card author-defined verb associated with this action.

data string | object

Initial data that input fields will be combined with. These are essentially ‘hidden’ properties.

associatedInputs enum
title
iconUrl
id
style
fallback
tooltip
isEnabled
mode
requires
userIds string[]

A list of user Ids informing the client for which users should the refresh action should be run automatically. Some clients will not run the refresh action automatically unless this property is specified. Some clients may ignore this property and always run the refresh action automatically.

TokenExchangeResource object

Defines information required to enable on-behalf-of single sign-on user authentication. Maps to the TokenExchangeResource type defined by the Bot Framework (https://docs.microsoft.com/dotnet/api/microsoft.bot.schema.tokenexchangeresource)

id string required

The unique identified of this token exchange instance.

uri string required

An application ID or resource identifier with which to exchange a token on behalf of. This property is identity provider- and application-specific.

providerId string required

An identifier for the identity provider with which to attempt a token exchange.

type enum

Must be TokenExchangeResource

Values: "TokenExchangeResource"
ImplementationsOf.Action
ImplementationsOf.Item
ImplementationsOf.ISelectAction
ImplementationsOf.Element
ImplementationsOf.ToggleableItem
ImplementationsOf.Inline
ImplementationsOf.Input
Extendable.Action object
title string

Label for button or link that represents this action.

iconUrl string

Optional icon to be shown on the action in conjunction with the title. Supports data URI in version 1.2+

format=uri-reference
id string

A unique identifier associated with this Action.

style enum

Controls the style of an Action, which influences how the action is displayed, spoken, etc.

Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.

tooltip string

Defines text that should be displayed to the end user as they hover the mouse over the action, and read when using narration software.

isEnabled boolean

Determines whether the action should be enabled.

Default: true
mode enum

Determines whether an action is displayed with a button or is moved to the overflow menu.

requires
Extendable.Element object

Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.

height enum
separator boolean

When true, draw a separating line at the top of the element.

spacing enum

Specifies how much spacing. Hosts pick the exact pixel amounts for each of these.

id
isVisible
requires
Extendable.Input object

Base input class

id string required

Unique identifier for the value. Used to identify collected input when the Submit action is performed.

errorMessage string

Error message to display when entered input is invalid

isRequired boolean

Whether or not this input is required

label string

Label for this input

Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.

height enum
separator boolean

When true, draw a separating line at the top of the element.

spacing enum

Specifies how much spacing. Hosts pick the exact pixel amounts for each of these.

isVisible boolean

If false, this item will be removed from the visual tree.

Default: true
requires Record<string, string>

A series of key/value pairs indicating features that the item requires with corresponding minimum version. When a feature is missing or of insufficient version, fallback is triggered.

Extendable.Item object
requires Record<string, string>

A series of key/value pairs indicating features that the item requires with corresponding minimum version. When a feature is missing or of insufficient version, fallback is triggered.

Extendable.ToggleableItem object
id string

A unique identifier associated with the item.

isVisible boolean

If false, this item will be removed from the visual tree.

Default: true
requires