Send message to Mave

POST

mave

chat

curl -X POST https://app.mavera.io/api/v1/mave/chat \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Analyze the competitive landscape for electric vehicles in Europe"
  }'

{
  "id": "<string>",
  "object": "mave_message",
  "thread_id": "<string>",
  "role": "assistant",
  "content": "<string>",
  "sources": [
    {
      "title": "<string>",
      "url": "<string>",
      "domain": "<string>"
    }
  ],
  "personas_used": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "usage": {
    "credits_used": 123
  },
  "created_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

Authorizations

Authorization

string

header

required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json

message

string

required

The user's message or query

thread_id

string

Existing thread ID (creates new thread if not provided)

workspace_id

string

Target workspace (uses default if not specified)

stream

boolean

default:false

If true, returns streaming SSE response

Response

Message processed successfully

Response from Mave chat

string

Message ID

object

enum<string>

Available options:

mave_message

thread_id

string

Thread ID

role

enum<string>

Available options:

assistant

content

string

AI response content

sources

object[]

Research sources used

Show child attributes

personas_used

object[]

Personas involved in the response

Show child attributes

usage

object

Show child attributes

created_at

string<date-time>

Update generation

List Mave threads

⌘I

curl -X POST https://app.mavera.io/api/v1/mave/chat \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Analyze the competitive landscape for electric vehicles in Europe"
  }'

{
  "id": "<string>",
  "object": "mave_message",
  "thread_id": "<string>",
  "role": "assistant",
  "content": "<string>",
  "sources": [
    {
      "title": "<string>",
      "url": "<string>",
      "domain": "<string>"
    }
  ],
  "personas_used": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "usage": {
    "credits_used": 123
  },
  "created_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

{
  "error": {
    "message": "Invalid API key.",
    "type": "authentication_error",
    "code": "invalid_api_key",
    "param": null
  }
}

System

Responses

Models

Personas

Custom Personas

Brand Voice

Generations

Mave

Workspaces

Projects

Meetings

Files

Folders

Video Analysis

Focus Groups

News

Usage

Send message to Mave

Authorizations

Body

Response