Skip to main content

Mpathic API (v1)

Download OpenAPI specification:Download

Behaviors

Detects behaviors in an input string.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

mpathic-profile
string

Optional. The profile ID for the request.

Request Body schema: application/json

The BehaviorsRequest that provides the input string and detection parameters.

user_metadata
any or null
confidence_threshold
number or null <double>

The confidence threshold for behaviors.

conversation_id
string or null

The unique identifier for the conversation associated with this behaviors request, if any.

include_suggestions
boolean

Indicates whether suggestions should be included for the detected behaviors.

include_tips
boolean

Indicates whether tips should be included for the detected behaviors.

include_definitions
boolean

Indicates whether definitions should be included for the detected behaviors.

input
required
string non-empty

The input string to for which to detect behaviors.

max_behaviors
integer or null <int32>

The maximum number of behaviors to return for each utterance in the input.

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "confidence_threshold": 0.5,
  • "conversation_id": "string",
  • "include_suggestions": false,
  • "include_tips": true,
  • "include_definitions": false,
  • "input": "Have you completed the document for our meeting?",
  • "max_behaviors": 2
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "created_at": 0,
  • "detections": [
    ]
}

Conversations

Provides analytics for conversations.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

mpathic-profile
string

Optional. The profile ID for the request.

Request Body schema: application/json

The ConversationsRequest that provides the conversation details.

user_metadata
any or null
conversation_id
string or null
confidence_threshold
number or null <double>
include_conversation
boolean
include_suggestions
boolean
include_tips
boolean
include_definitions
boolean
include_diagnostics
boolean
max_behaviors
integer or null <int32>
required
Array of objects (ConversationTalkTurn) non-empty

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "conversation_id": "string",
  • "confidence_threshold": 0.1,
  • "include_conversation": true,
  • "include_suggestions": true,
  • "include_tips": true,
  • "include_definitions": true,
  • "include_diagnostics": true,
  • "max_behaviors": 0,
  • "talk_turns": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "conversation_id": "string",
  • "created_at": 0,
  • "analytics": {
    },
  • "conversation": {
    }
}

update-conversation-metadata

Authorizations:
bearer
header Parameters
mpathic-id
string
mpathic-profile
string
Request Body schema: application/json
conversation_id
string <uuid>
object or null
merge_existing
boolean

Responses

Request samples

Content type
application/json
{
  • "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",
  • "metadata": {
    },
  • "merge_existing": true
}

ConversationsJobs

Starts a conversations job.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

mpathic-profile
string

Optional. The profile ID for the request.

Request Body schema: application/json

The ConversationsRequest that provides the conversation details.

user_metadata
any or null
conversation_id
string or null
confidence_threshold
number or null <double>
include_conversation
boolean
include_suggestions
boolean
include_tips
boolean
include_definitions
boolean
include_diagnostics
boolean
max_behaviors
integer or null <int32>
required
Array of objects (ConversationTalkTurn) non-empty

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "conversation_id": "string",
  • "confidence_threshold": 0.1,
  • "include_conversation": true,
  • "include_suggestions": true,
  • "include_tips": true,
  • "include_definitions": true,
  • "include_diagnostics": true,
  • "max_behaviors": 0,
  • "talk_turns": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "status": "string",
  • "conversations_response": {
    },
  • "upload": {
    }
}

Get conversations job status.

Authorizations:
bearer
path Parameters
id
required
string

Conversations job ID

header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

mpathic-profile
string

Optional. The profile ID for the request.

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "status": "string",
  • "conversations_response": {
    },
  • "upload": {
    }
}

/v1/conversations/jobs/start-multipart

Authorizations:
bearer
header Parameters
mpathic-id
string
mpathic-profile
string
Request Body schema: application/json
user_metadata
any or null
file_name
required
string non-empty
file_size_bytes
required
integer <int64>
content_type
required
string non-empty
preferred_part_size_bytes
integer or null <int64>

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "file_name": "string",
  • "file_size_bytes": 0,
  • "content_type": "string",
  • "preferred_part_size_bytes": 0
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "conversation_id": "string",
  • "status": "string",
  • "upload": {
    }
}

/v1/conversations/jobs/{id}/complete-multipart

Authorizations:
bearer
path Parameters
id
required
string
header Parameters
mpathic-id
string
mpathic-profile
string
Request Body schema: application/json
user_metadata
any or null
Array of objects or null (ConversationsMultipartCompletePart)

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "parts": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "status": "string",
  • "conversations_response": {
    },
  • "upload": {
    }
}

/v1/conversations/jobs/{id}/cancel-multipart

Authorizations:
bearer
path Parameters
id
required
string
header Parameters
mpathic-id
string
mpathic-profile
string
Request Body schema: application/json
user_metadata
any or null
reason
string or null

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "reason": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "status": "string",
  • "conversations_response": {
    },
  • "upload": {
    }
}

Files

Uploads a multipart streamed file.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic-id for the upload request.

mpathic-profile
string

Optional. The mpathic-profile for the upload request.

Request Body schema: multipart/form-data
file_id
string

Optional. The file_id for the request. If provided, it should be a UUID as specified by RFC 4122.

user_metadata
string

The user_metadata for the request, which should be a valid JSON document.

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "file_id": "string",
  • "message": "string"
}

Imports a recording from Zoom and uploads it as a file.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic-id for the upload request.

mpathic-profile
string

Optional. The mpathic-profile for the upload request.

Request Body schema:

The Zoom import request containing the recording details.

credentials_id
string or null

The Zoom credentials ID to use for the import.

meeting_id
string or null

The Zoom meeting ID.

recording_file_id
string or null

The Zoom recording file ID.

user_metadata
any or null

Optional user metadata for the file.

Responses

Request samples

Content type
{
  • "credentials_id": "string",
  • "meeting_id": "string",
  • "recording_file_id": "string",
  • "user_metadata": null
}

Response samples

Content type
application/json
{
  • "file_id": "string",
  • "message": "string",
  • "user_metadata": null
}

Profile

Provides information about your default or specified mpathic profile.

Authorizations:
bearer
header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

mpathic-profile
string

Optional. The profile ID for the request.

Request Body schema: application/json

Optional. Filters for the profile request.

user_metadata
any or null
role
string or null

Optional role for determining active behaviors.

metadata
any or null

Optional metadata for determining active behaviors.

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "role": "string",
  • "metadata": null
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "created_at": 0,
  • "allow_suggestions": true,
  • "allow_tips": true,
  • "behaviors": [
    ],
  • "profile_id": "string"
}

Token

Gets an authorization bearer token for the specified credentials.

header Parameters
mpathic-id
string

Required. The mpathic ID for the request.

Request Body schema: application/json

The TokenRequest that provides the information required to obtain a token.

user_metadata
any or null
grant_type
required
string non-empty

The grant type being requested.

client_id
required
string non-empty

The client ID for the token request.

client_secret
required
string non-empty

The client secret for the token request.

Responses

Request samples

Content type
application/json
{
  • "user_metadata": null,
  • "grant_type": "client_credentials",
  • "client_id": "...",
  • "client_secret": "..."
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "user_metadata": null,
  • "api_version": "string",
  • "access_token": "string",
  • "expires_in": 0,
  • "token_type": "string"
}