Create meeting schema

Create a new custom schema for extracting structured data from meeting transcripts.

POST /meetings/schemas

cURL

cURL

curl -X POST https://app.mavera.io/api/v1/meetings/schemas \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Discovery Call",
    "description": "Extract key information from sales discovery calls",
    "category": "sales_discovery",
    "fields": [
      {
        "name": "budget_range",
        "label": "Budget Range",
        "field_type": "enum",
        "enum_options": ["<10k", "10k-50k", "50k-100k", ">100k"],
        "is_required": true,
        "requires_evidence": true
      },
      {
        "name": "decision_makers",
        "label": "Decision Makers",
        "field_type": "list",
        "requires_evidence": true
      },
      {
        "name": "timeline",
        "label": "Expected Timeline",
        "field_type": "text",
        "requires_evidence": true
      }
    ]
  }'

201

{
  "id": "<string>",
  "object": "meeting.schema",
  "name": "<string>",
  "description": "<string>",
  "category": "sales_discovery",
  "is_built_in": true,
  "is_published": true,
  "version": 123,
  "workspace_id": "<string>",
  "user_id": "<string>",
  "is_marketplace": true,
  "author_name": "<string>",
  "author_email": "<string>",
  "downloads": 123,
  "average_rating": 123,
  "tags": [
    "<string>"
  ],
  "fields": [
    {
      "id": "<string>",
      "name": "<string>",
      "label": "<string>",
      "field_type": "text",
      "is_required": true,
      "requires_evidence": true,
      "enum_options": [
        "<string>"
      ],
      "scoring_enabled": true,
      "scoring_rubric": {},
      "crm_field_mapping": {},
      "order": 123
    }
  ],
  "field_count": 123,
  "usage_count": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

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

Body

application/json

name · string · required

Schema name

Required string length: 1 - 100

fields · object[] · required

Required array length: 1 - 50 elements

Show child attributes

description · string

Schema description

category · enum<string> · default: custom

Category of the meeting schema

Available options: sales_discovery, qualification, objection_competitor, cs_health, product_feedback, custom

workspace_id · string

Workspace ID (uses default workspace if not specified)

Response

201

application/json

Schema created successfully

id · string

object · enum<string>

Available options: meeting.schema

name · string

description · string | null

category · enum<string>

Category of the meeting schema

Available options: sales_discovery, qualification, objection_competitor, cs_health, product_feedback, custom

is_built_in · boolean

Whether this is a system-provided schema

is_published · boolean

Whether this schema is published to marketplace

version · integer

workspace_id · string | null

user_id · string | null

is_marketplace · boolean

author_name · string | null

author_email · string | null

downloads · integer | null

average_rating · number | null

tags · string[] | null

fields · object[]

Show child attributes

field_count · integer

usage_count · integer

Number of times this schema has been used

created_at · string<date-time>

updated_at · string<date-time>