MXPROCESS

Synchronous API: AI Meeting Brief

A free account is required before using this API. Create and validate your account on /zh/create-account, then obtain your JWT token with your credentials.

Upload one meeting recording and receive, in the same HTTP response, a transcription, executive brief, action register and follow-up email draft.

Endpoint: POST https://mxprocess.com/api/files/start-process
Authentication: Bearer JWT obtained from POST /api/login_check
Cost: 18 tokens per successful execution.

Request

The request must be multipart/form-data. The parameters field is a JSON string, not a nested multipart object.

curl --location --request POST 'https://mxprocess.com/api/files/start-process' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'Accept: application/json' \
--form 'file=@"/absolute/path/weekly-review.mp4"' \
--form 'actionName=MeetingBrief' \
--form 'parameters=[["language",["French"]],["audience",["project team"]],["focus",["decisions, actions, risks and open questions"]]]' \
--form 'async=false'

Accepted files: MP3, WAV, M4A, AAC, OGG, FLAC, WebM, MP4, MOV, MKV and AVI. Only one recording is accepted. language, audience and focus are optional; the defaults are French, project team, and decisions/actions/risks/open questions.

Use synchronous mode only when your HTTP client can wait for transcription and analysis. For long recordings, use the asynchronous API.

Successful response

The output field contains the structured brief and downloadResults. For compatibility with the existing synchronous endpoint, the persisted action request is serialized under the "0" key; use 0.id to download files through the authenticated endpoint below.

{
  "output": {
    "brief": {
      "title": "Weekly project review",
      "executive_summary": "...",
      "decisions": [{"decision": "...", "evidence": "..."}],
      "action_items": [{"task": "...", "owner": "", "due_date": "", "priority": "high", "evidence": "..."}],
      "risks": [],
      "open_questions": [],
      "follow_up_email": {"subject": "...", "body": "..."}
    },
    "downloadResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  },
  "0": {
    "id": 123,
    "accomplished": true,
    "actionResults": [
      ["weekly-review-transcript.txt", "https://..."],
      ["weekly-review-meeting-brief.md", "https://..."],
      ["weekly-review-meeting-brief.json", "https://..."]
    ]
  }
}

Download a deliverable

Replace ACTION_ID with the action request ID returned by the call and use the exact filename from downloadResults.

curl --location --request GET 'https://mxprocess.com/api/actions/download-action-result/ACTION_ID/weekly-review-meeting-brief.json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--output weekly-review-meeting-brief.json

Functional error example

{
  "error": "ERROR_MB004 MeetingBrief accepts audio or video recordings only."
}