---
title: "Engage Genagent in a conversation."
method: POST
path: "/mg-genagent/v1/engage"
tags: ["Engage"]
---

# Engage Genagent in a conversation.

`POST /mg-genagent/v1/engage`

## Request

- Base URL: `https://api.sandbox.asapp.com`
- URL: `https://api.sandbox.asapp.com/mg-genagent/v1/engage`
- Auth: API key in header `asapp-api-id` and API key in header `asapp-api-secret`
- TypeScript: <https://skmtc.dev/asapp/apis/mg-genagent-api-router/docs/mg-genagent/v1/engage/post.ts> (a function with typed inputs; its response is checked against the schema)

Engage Genagent in a conversation.

## Request body

- object
  - `namespace` 'amazonconnect', required: Namespace for media gateway
  - `guid` string, required: Globally Unique Id, also sometimes called Unique Call Id (UCID). Must be in decimal form.
  - `language` 'en-US': Language of the conversation, defaults to en-US.
  - `inputVariables` object: Input variables to be used as context in the analysis.
  - `amazonConnectParams` object
    - `streamArn` string: Amazon stream arn
  - `customerId` string, required: Id of the customer on the call. Usually taken from Call Center CTI information.

## Response `204`

Router processed the request, details are in the response body

## Other responses

- `400`: 400 - Bad request
- `401`: 401 - Unauthorized
- `403`: 403 - Forbidden
- `404`: 404 - Not Found
- `409`: 409 - Conflict
- `413`: 413 - Request Entity Too Large
- `422`: 422 - Unprocessable Entity
- `429`: 429 - Too Many Requests
- `503`: 503 - Service Unavailable
- `default`: 500 - Internal Server Error

---

[API](https://skmtc.dev/asapp/apis/mg-genagent-api-router.md) - [All operations](https://skmtc.dev/asapp/apis/mg-genagent-api-router/llms.txt) - [OpenAPI document](https://skmtc.dev/asapp/apis/mg-genagent-api-router/revisions/0abe4f32734e?raw)