:root {
  --Foreground-Fg: #251C1D;
  --Foreground-Fg-Dark: #c1c1c1;
  --Foreground-FgSecondary: rgba(37, 28, 29, 0.64);
  --Foreground-FgSecondary-Dark: rgba(249, 249, 251, 0.64);
  --Background-Bg: #2F2E32;
  --article-text: rgba(37, 28, 29, 0.8);;
  --dark-article-text: var(--Foreground-FgSecondary-Dark);
  --Brand-brandPrimary: #6447C4;
  --Background-BgSecondary: #FAF7F6;
  --Background-BgSecondary-Dark: #28272B;
  --Border-border: rgba(136, 99, 101, 0.24);
  --Border-border-Dark: rgba(47, 54, 62);
  --Accent-accent4: #CAB0D9;
  --Accent-accent3: #D9BAFC;
  --Accent-accent4-Dark: #A998B8;
}



h6, body, ul, ol, p {
  /* font-family: MessinaSans, Arial, Sans Serif; */
  /* font-size: 14px; */
}

.font-semibold {
  font-weight: 600;
}

html {
  font-size: 16px;
  /* font-weight: 500; */

}
html *, html :after, html :before {
  border-color: var(--Border-border); 
}
.prose tr:is(.dark *) {
  border-color: var(--Border-border-Dark); 
}

.dark *,
.dark :after,
.dark :before {
  /* border-color: var(--Border-border-Dark);  */
}

.hidden.absolute.dark\:block.inset-0.overflow-hidden.h-\[64rem\] {
  /* background: radial-gradient(95% 55% at 60% -30%, #2A0F5B 15.4%, rgba(0, 0, 0, 0) 100%) !important */
}

Main > span.fixed.inset-0[style*="background-image"] {
  background-position: center bottom !important;
  background-size: 1600px;
}



.bg-primary-dark.rounded-full {
  background-color: var(--Brand-brandPrimary);
}

a[href^="https://www.asapp.com"] span.rounded-full {
  border-radius: 0px;
}


.dark\:border-gray-800\/50:is(.dark *) {
  border-color: var(--Border-border-Dark); 
}
.prose {
  color: var(--article-text)
}
.dark .prose {
  /* color: var(--dark-article-text) */
}
.prose:is(.dark *) {
  color: var(--dark-article-text)
}
.prose p:not(.not-prose *) {
  margin-bottom: 16px;
  /* font-weight: 500; */
}


#content-area :where(h1, h2, h3, h4, h5) {
  font-family: MessinaSans, Helvetica, Arial, sans-serif;
}
#content-area h1 {
  font-size: 28px;
}

/* code, pre, .code, .font-mono {
  font-family: "Messina Sans Mono", monospace;
  font-size: .85rem;
} */
a[href^="https://mintlify.com"] {
  display: none;
}
/* Card */
#content-area .card p {
  font-size: 14px;
}
#content-area .prose :where(h2, h3, h4, h5):not(.card *) {
  margin-top: 24px;
}
#content-area .card svg:min-width(200px){
  margin-bottom: .5rem;
}

#content-area .card:has(div>div > h2:empty):has(div>div p) div:has(svg) {
  margin-bottom: 1.25rem; 
}

.dark #content-area .card:has(div>div > h2:empty) div:has(svg) svg path {
  fill: #ac6df3 !important;
}
.dark #content-area .card:has(div>div > h2:empty) div:has(svg) svg g[clip-path="url(#clip0_396_970)"] g {
  mask: unset !important;
}

/* page layout */
@media (min-width: 1220px) {
  #table-of-contents.xl\:flex {
      display: flex;
  }
  #table-of-contents.xl\:hidden {
    display: none;
  }
}

@media (min-width: 1024px) {

  #content-area.lg\:pl-\[23\.7rem\] {
    padding-left: 22rem;
  }

  #navbar .lg\:px-12 {
    padding-left: 2rem;
  }
}
#navbar .px-12 {
  padding-left: 2rem;
}
#table-of-contents.pl-10 {
  padding-left: 1rem;
}

#table-of-contents.w-\[19rem\] {
  width: 14rem;
}

#table-of-contents .w-\[16\.5rem\] {
  width: 14rem;
}
#content-container .gap-12 {
  gap: 1rem;
}

.max-w-8xl {
  max-width: 86rem;
}

/* Remove gap top of content */
#content-area> div.relative {
  margin-top: 1rem;
}

#content-area >header >div.prose {
  margin-top: unset;
  
}

#content-area >header >div.prose p {
  font-size: 18px;
  /* color: rgb(var(--gray-900)); */
}
.dark #content-area >header >div.prose p {
  font-size: 18px;
  /* color: rgb(var(--gray-200)); */
}

/* sidebar color */
.bg-gray-950\/\[0\.03\] {
  background-color: unset;
}

.dark .bg-gray-950\/\[0\.03\] {
  background-color: unset;
}

/* Border */
#navbar-transition,
table,
#content-area >div.prose >div>div.not-prose .border {
  border-color: var(--Border-border);
}

.dark #navbar-transition,
.dark table,
.dark #content-area >div.prose >div>div.not-prose .border {
  border-color: var(--Border-border-Dark);
}

/* Links */

.prose a {
  /* font-weight: 600; */
}

.prose :where(a:hover):not(:where([class~=not-prose],[class~=not-prose] *)) {
  font-weight: 600 !important; 
}
/* Code */

html:not(.dark) code[language] {
  filter: 
          /* sepia(60%)
          hue-rotate(230deg) */
          saturate(250%);
}

.dark\:border-gray-800:is(.dark *) {
  border-color: var(--Border-border-Dark);
}

.dark\:bg-codeblock:is(.dark *) {
  background-color: #07111a;
}

.prose a:has(>code) {
  border-bottom-width: 0px;
  /* color: var(--Brand-brandPrimary)  */
}

.prose a:has(>code):hover {
  /* border-bottom-width: 2px; */
}

.prose a[href^="/apis"]:after {
  content: "API";
  font-size: .65rem;
  font-weight: 400;
  padding-left: 3px;
  padding-right: 3px;
  padding-top: 1px;
  padding-bottom: 1px;
  margin-left: 3px;
  color: var(--Background-BgSecondary);
  background-color: var(--Brand-brandPrimary);
  /* border: 1px solid var(--Border-border); */
  border-radius: 3px;
  vertical-align: middle;
}


.dark .prose a[href^="/apis"]:after {
  /* background-color: var(--Background-Bg-Dark); */
  /* color: var(--Foreground-Fg-Dark); */
}
  

.prose :not(pre)>code {
  background-color: unset;
  /* border-color: var(--Accent-accent4); */
  border-color: var(--Accent-accent3);
  line-height: 18px;
  border-width: 1px;
  /* font-weight: 500; */
  /* font-size: .95rem; */
}

.prose strong:not(pre)>code {
  font-weight: 700;
}
.dark .prose :not(pre)>code {
  border-color: var(--Border-border-Dark);
}
:not(pre)>code:is(.dark *) {
  --tw-brightness: unset;
}
.prose :has(> code){
  white-space: pre-wrap;
}

code .token.string {
  color: var(--Accent-accent3)
}
/* Navbar */
#sidebar a[href="/"] {
  position: relative;
  display: inline-flex;
  align-items: center;
}

#sidebar a[href="/"]:after {
  content: "Docs";
  position: static;
  margin-left: 0.5em;
  font-size: 18px;
}

#navbar a {
  /* font-size: 14px; */
  font-weight: 600;
  /* color: var(--Foreground-FgSecondary); */
}

.dark #navbar a {
  /* color: var(--dark-article-text); */
}

#navbar > div > div > div.hidden a:not([class*="group-hover"]) {
  /* color: var(--Foreground-Fg) */
}
.dark #navbar > div > div > div.hidden a:not([class*=group-hover]) {
  /* color: var(--Foreground-Fg-Dark) */
}
#navbar > div > div > div.hidden a:not([class*="group-hover"]) >div {
  height: 3px;
}
/*Table of contents */

#table-of-contents a {
  /* font-size: 14px; */
  /* font-weight: 600; */
  /* color: var(--Foreground-Fg) */
}

#table-of-contents svg {
  /* display: none; */
}
#table-of-contents ul >li:not([style*="margin-left"]) a  {
  /* font-weight: 500; */
}
#table-of-contents ul >li[style*="margin-left"]  a {
  /* font-weight: 500; */
}
#table-of-contents>div>div>span {
  /* margin-left: 5px; */
  /* text-transform: uppercase; */
  /* font-size: 16px;  */
  /* font-weight: 700; */
  /* color: var(--Foreground-FgSecondary); */
}

.dark #table-of-contents>div>div>span {
  color: var(--dark-article-text)
}
/* Tables */

#content-area .prose :where(table ){
  border-width: 1px;
  border-radius: 4px;
  width: fit-content;
  max-width: 100%;
}

#content-area .prose :where(thead th:first-child, tbody tr td:first-child) {
  padding-left: 12px;
}

#content-area prose :where(thead th:last-child, tbody tr td:last-child){
  padding-right: 12px;
}
#content-area .prose :where(thead th) {
  padding-top: 12px;
  padding-inline-end: 8px;
  /* width: 1%; /* this somehow fixes table width issues */
}

#content-area .prose :where(ul) {
  margin-top: 0px;
  /* margin-bottom: 0px; */
}

#content-area .prose :where(thead) {
  background-color: var(--Background-BgSecondary);
}

.dark #content-area .prose :where(thead) {
  background-color: var(--Background-BgSecondary-Dark);
}

#content-area .prose table td{
  font-size: 1rem;
}

#content-area .prose table td {
  padding-inline-end: 8px;
}

/* unordered lists */
#content-area  .prose :where(ul:not(.not-prose) > li):before{
  background-color: unset;
  content: "▪";
  top: unset;
  font-size: 16px;
  padding-left: 8px;
  padding-right: 8px;
}

/* ordered lists */
#content-area  .prose :where(ol) {
  list-style-type: none;
  counter-reset: item;
  padding-left: 0;
}

#content-area .prose :where(ol > li) {
  counter-increment: item;
  position: relative;
  padding-left: 28px; /* Adjust based on your counter size and desired spacing */
  margin-bottom: 10px;
}

#content-area .prose :where(ol > li)::before {
  content: counter(item);
  position: absolute;
  left: 0;
  top: 5px;
  background: var(--Brand-brandPrimary);
  border-radius: 4px;
  color: white;
  width: 18px;
  height: 18px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 12px;
  line-height: 1;
  font-weight: 700;
}



.dark #content-area  .prose :where(ol >li)::before {
  /* color: var(--Background-Bg) */
}

/* .prose :where(ol > li) > * {
  margin-top: 0;
  margin-bottom: 0;
} */

/* Hide the automatically generated marker */
#content-area  .prose :where(ol > li)::marker {
  display: none !important;
}

/* Accordian in dark mode */
.dark #content-area  div[role=listitem] {
  background-color: unset;
}
#content-area  div[role=listitem] button p{
  font-weight: 700;
}
/* Navigation sidebar */

.dark #navigation-items * {
  /* color: var(--Foreground-Fg-Dark) */
}

#navigation-items a * {
  /* font-weight: 500; */
}

#navigation-items h5 {
  font-weight: 700;
  font-size: 14px;
}

/* Tabs */
#content-area .prose ul>li>button{
  font-size: 1rem;
  font-weight: 700;
}


/* API Ref */

.border-gray-100 {
  border-color: var(--Border-border)
}
.py-6 {
  padding-top: 1rem;
  padding-bottom: 1rem;
}
.mt-4 {
  margin-top: .5rem;
}
.py-6 >.font-mono .text-primary {
  font-size: .95rem;
}
.mt-4 .prose:last-child p:last-child{
  margin-bottom: 0;
}
.prose-sm {
  font-size: .9rem;
}

.group.flex.font-mono {
  /* flex-wrap: wrap; */
  gap: 0rem;
}

/* API ref puts description as the page description which we want to appear as normal content */
main:has(#navbar > div > div > div.hidden a[href^="/apis"]:not([class*="group-hover"])) {
  & #content-area >header >div.prose {
    margin-top: 1rem;
  }
  & #content-area >header >div.prose.text-lg {
    font-size: 1rem;
  }
  & #content-area >header >div.prose p {
    font-size: 1rem;
  }
}

/* Header anchor */
#content-area :where(h1, h2, h3, h4, h5) .absolute > a {
  margin-left: -1.75rem;
}

/* List of steps */
.dark\:text-gray-200:is(.dark *) {
  color: rgb(var(--gray-200));
}

div[role="list"] > div[role="listitem"] > div.absolute > div.items-center {
  background-color: var(--Brand-brandPrimary);
  color: var(--Foreground-Fg-Dark);
}

/* Callouts */

#content-area div.flex:has(
  > div > svg[aria-label="Tip"],
  > div > svg[aria-label="Note"],
  > div > svg[aria-label="Warning"],
  > div > svg[aria-label="Info"]
  ) > div.prose > p:last-child {
  margin-bottom: 0px;
}

Get a specific structured data field specifying the id


Retrieve a structured data field

API ID & API Secret

Successfully retrieved the structured data field.

Question

Entity

ASAPP Docs

Welcome

Welcome to ASAPP

Overview

New updates and improvements across ASAPP products

ASAPP Updates

New updates and improvements for the GenerativeAgent

GenerativeAgent

GenerativeAgent Updates

New updates and improvements across AutoSummary

AutoSummary

AutoSummary Updates

New updates and improvements for the Conversation Explorer and Reporting

Reporting

Reporting Updates

New updates and improvements across AutoTranscribe

AutoTranscribe

AutoTranscribe Updates

New updates and improvements across AutoCompose

AutoCompose

AutoCompose Updates

Getting Started

Setup ASAPP

Manage Users

Learn how to view, search, and export audit logs to track changes in AI Console.

Audit Logs

Learn how to get started using ASAPPs APIs

Developer Quickstart

Learn how ASAPP returns Errors in the API

Error Handling

Learn about API rate limits and recommended retry logic.

Rate Limits

API Rate Limits and Retry Logic

Check the operational status of ASAPP's API platform

Health Check

Use GenerativeAgent to resolve customer issues safely and accurately with AI-powered conversations.

Discover how GenerativeAgent functions to resolve customer issues.

How It Works

How GenerativeAgent Works

Learn how to track and analyze GenerativeAgent's performance.

Learn how GenerativeAgent works with human agents to handle complex cases requiring expert guidance or approval.

Human in the Loop

Go Live

Use ASAPP Messaging to connect your brand to customers via messaging channels.

ASAPP Messaging

Use AutoSummary to extract insights and data from your conversations

Learn how to get started with AutoSummary

See examples on how AutoSummary can be used

Example Use Cases

Learn how to use the AutoSummary Sandbox to test and validate summary generation.

Sandbox

AutoSummary Sandbox

Learn how to use the AutoSummary Salesforce plugin.

Salesforce plugin

Deploying AutoSummary for Salesforce

Transcribe your audio with best in class accuracy

Integrate AutoTranscribe into your SIPREC system using ASAPP Media Gateway

SIPREC Connector

Deploy AutoTranscribe into SIPREC via Media Gateway

Twilio Connector

Deploying AutoTranscribe for Twilio

Use AutoTranscribe in your Amazon Connect solution

Amazon Connector

Deploying AutoTranscribe for Amazon Connect

Use AutoTranscribe in your Genesys Audiohook application

Genesys AudioHook Connector

Deploying AutoTranscribe for Genesys AudioHook

Use a websocket URL to send audio media to AutoTranscribe

Direct Websocket

AutoTranscribe via Direct Websocket

Learn more about the use of AutoTranscribe and its features

Product Guide

AutoTranscribe Product Guide

AutoCompose API

Deploying AutoCompose API

Use AutoCompose on your LivePerson application.

LivePerson Connector

Deploying AutoCompose for LivePerson

Use AutoCompose on Salesforce Lightning Experience.

Salesforce Connector

Deploying AutoCompose for Salesforce

Learn how to use the AutoCompose tooling UI

Tooling Guide

AutoCompose Tooling Guide

Learn more about the features and insights of AutoCompose

AutoCompose Product Guide

Reporting and Insights

Learn how to use File Exporter to retrieve data from Standalone ASAPP Services.

File Exporter

Learn how to retrieve data from ASAPP Messaging

Retrieving Data for ASAPP Messaging

Learn how to send metadata via Metadata Ingestion API.

Metadata Ingestion API

Security

Learn how Data Redaction removes sensitive data from your conversations.

Data Redaction

Use External IP Blocking to block IP addresses from accessing your data.

External IP Blocking

Learn how to securely handle Customer Information.

Warning about CustomerInfo and Sensitive Data

Creates a new conversation or updates an existing one based on the provided `externalId`.

Use this endpoint when:
- Starting a new conversation
- Updating conversation details (e.g., reassigning to a different agent)

If the `externalId` is not found, a new conversation will be created. Otherwise, the existing conversation will be updated.


Create or update a conversation

Retrieves a list of conversation resources that match the specified criteria.

You must provide at least one search criterion in the query parameters.


List conversations

Retrieves the details of a specific conversation using its `conversationId`.

This endpoint returns detailed information about the conversation, including participants and metadata.


Retrieve a conversation

Stores customer-specific authentication credentials for use in integrated flows.

- Can be called at any point during a conversation
- Commonly used at the start of a conversation or after mid-conversation authentication
- May trigger additional actions, such as GenerativeAgent API signals to customer webhooks

<Note>This API only accepts the customer-specific auth credentials; the customer is responsible for handling 
the specific authentication mechanism.</Note>


Authenticate a user in a conversation

Creates a message object, adding it to an existing conversation.

Use this endpoint to record each new message in the conversation.


Create a message

Lists all messages within a conversation.

This messages are returned in chronological order. 


List messages

Retrieve the details of a message from a conversation.


Retrieve a message

This creates multiple message objects at once, adding them to an existing conversation.

Use this endpoint when you need to add several messages at once, such as when importing historical conversation data.


Create multiple messages

List messages with an externalId

Call this API to trigger GenerativeAgent to analyze and respond to a conversation.

This API should be called after a customer sends a message while not speaking with a live agent. The Bot replies will not be returned on this request; they will be delivered asynchronously via the webhook callback.

This API also adds an optional **message** field to create a message for a given conversation before triggering the bot replies. The message object is the exact same message used in the conversations API /message endpoint


Analyze conversation

This API creates a generative agent event streaming URL to start a streaming connection (SSE).

This API should be called when the client boots-up to request a streaming_url, before it calls endpoints whose responses are delivered asynchronously (and most likely before calling any other endpoint).

Provide the streamId to reconnect to a previous stream.


Create stream URL

This API provides the current state of the generative agent for a given conversation.


Get GenerativeAgent state

Get [websocket streaming URL](/autotranscribe/deploying-autotranscribe-via-websocket) to transcribe audio in real time. This websocket is used to send audio to ASAPP's transcription service and receive transcription results.


Get streaming URL

The API Health check endpoint enables you to check the operational status of our API platform.


ASAPP APIs

Retrieve a structured data field

Authorizations

Path Parameters

Response