---
title: "Invoke an action"
method: POST
path: "/action"
---

# Invoke an action

`POST /action`

This API accepts the serialized MindMeld Request and Responder and returns a serialized Responder

## Request body

- Data
  - `request` Request — The request object is the object that encapsulates the information sent from the device client to the MM server
    - `text` string — The query text
    - `domain` string — Domain of the current query.
    - `intent` string — Intent of the current query.
    - `entities` Entity[] — A list of entities in the current query.
      - `text` string — The text contents that span the entity
      - `type` string — Entity type
      - `role` string, nullable — Role type
      - `value` object — The resolved value of the entity
      - `display_text` string — A human readable text representation of the entity for use in natural language responses.
      - `confidence` number — A confidence value from 0 to 1 about how confident the entity recognizer was for the given class label.
      - `is_system_entity` boolean — True if the entity is a system entity
    - `context` object — Map containing front-end client state that is passed to the application from the client in the request.
    - `params` Params
      - `target_dialogue_state` string, nullable — The name of next turn's dialogue state (if set)
      - `dynamic_resource` object, nullable — The additional values for gazetteer
      - `allowed_intents` string[], nullable — The list of allowed intents for next turn (if set)
      - `time_zone` string, nullable — The time zone of the request
      - `language` string, nullable — The language of the request
      - `locale` string, nullable — The locale of the request
      - `timestamp` integer, nullable — The timestamp of the request
  - `responder` Responder
    - `directives` Directive[] — The list of directives (such as replies) to be sent to the user
      - `name` string — Directive Name
      - `type` 'view' | 'action' — Directive Type
      - `payload` object — JSON payload
    - `frame` object — The frame object of the responder, which contains key-value pairs to send to the application
    - `params` Params
      - `target_dialogue_state` string, nullable — The name of next turn's dialogue state (if set)
      - `dynamic_resource` object, nullable — The additional values for gazetteer
      - `allowed_intents` string[], nullable — The list of allowed intents for next turn (if set)
      - `time_zone` string, nullable — The time zone of the request
      - `language` string, nullable — The language of the request
      - `locale` string, nullable — The locale of the request
      - `timestamp` integer, nullable — The timestamp of the request
    - `slots` object — The slots object of the responder, which contains key-value pairs that can be used to render the natural language responses
  - `action` string — The name of the action

## Response `200`

OK

- Responder
  - `directives` Directive[] — The list of directives (such as replies) to be sent to the user
    - `name` string — Directive Name
    - `type` 'view' | 'action' — Directive Type
    - `payload` object — JSON payload
  - `frame` object — The frame object of the responder, which contains key-value pairs to send to the application
  - `params` Params
    - `target_dialogue_state` string, nullable — The name of next turn's dialogue state (if set)
    - `dynamic_resource` object, nullable — The additional values for gazetteer
    - `allowed_intents` string[], nullable — The list of allowed intents for next turn (if set)
    - `time_zone` string, nullable — The time zone of the request
    - `language` string, nullable — The language of the request
    - `locale` string, nullable — The locale of the request
    - `timestamp` integer, nullable — The timestamp of the request
  - `slots` object — The slots object of the responder, which contains key-value pairs that can be used to render the natural language responses

## Other responses

- `405` — Invalid input

---

[API](https://skmtc.net/cisco/apis/mindmeld-action-server.md) · [All operations](https://skmtc.net/cisco/apis/mindmeld-action-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cisco/mindmeld-action-server/versions/b530c2709979/schema)