The Miles API

Routes the input through Miles's intent parser and the matching handler — calendar, inbox, tasks, memory, transcripts, and more. Returns a natural-language response plus any structured data Miles surfaced.

Request body

curl -X POST https://api.heymiles.app/api/v1/ask \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Find inbox info for my 4pm meeting"}'

{
  "intent": "meeting_prep",
  "response": "From your inbox, three threads relate to your 4pm with Sarah...",
  "data": {
    "meetings": [{ "summary": "Pricing review", "time": "4:00 PM - 4:30 PM" }],
    "emails": [{ "subject": "Re: Pricing draft", "from": "sarah@…", "snippet": "…" }]
  },
  "navigation": "/meetings/<id>/prep",
  "suggestedFollowups": ["Draft a follow-up", "What's after this meeting?"]
}

Runs the transcript through Miles's processing pipeline: rich markdown summary (lead + Overview + sectioned notes), action items with priorities, decisions with reasoning, topics, attendees, and a drafted follow-up email. Side-effect: creates Tasks and Action records in the user's app.

curl -X POST https://api.heymiles.app/api/v1/transcripts \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "meetingTitle": "Vectris Q2 sync",
    "meetingDate": "2026-05-09T14:00:00Z",
    "attendees": ["Bill Barry", "Vicki Chen"],
    "rawTranscript": "Speaker 1: Lets review pricing..."
  }'

Response

{
  "transcriptId": "clx…",
  "summary": "Bill and Vicki aligned on Q2…\n\n**Overview**\n- …",
  "actionItems": [{ "title": "Send pricing deck by EOD Friday", "priority": "immediate" }],
  "decisions": [{ "topic": "Pricing model", "decision": "Per-seat for Q2" }],
  "topics": ["pricing", "Q2 launch"],
  "tasksCreated": 3,
  "memoryRecords": 5,
  "followUpDrafted": true
}

List the Recall.ai bot recordings available for grabbing. Each record carries a botId (use it directly with /transcripts/grab for the cheapest match), meeting title/date, current status, and whether it's already been processed.

Pull a transcript from a Recall.ai bot recording (Miles' own bot) and run it through the processing pipeline. Equivalent to the in-app "Grab Transcript" button, exposed for automation. Either pass botId directly (best) or any of meetingTitle, meetingDate, meetingId and Miles fuzzy-matches a recording.

{ "botId": "abc123" }
// — or —
{ "meetingTitle": "Q2 Pricing Call", "meetingDate": "2026-05-09T14:00:00Z" }

Response status values

The single most recent processed meeting with full detail. Powers "what was my last meeting about?" use cases without needing to list-then-fetch.

curl https://api.heymiles.app/api/v1/meetings/last \
  -H "Authorization: Bearer $KEY"

List processed meetings, most-recent-first. range is past (default) or today. Returns brief previews + counts.

Full detail for one meeting: rich markdown summary, raw transcript, actionItems, decisions, topics, followUpDraft.

Remove a meeting and its derived records (action items, decisions, follow-up draft, memory entries). Returns { deleted: true }.

Delete up to 200 meetings in one call. Body: { "ids": [...] }. Returns { deleted, errors, requested }.

Create or update a contact. Upserts by (userId, email). Email is optional when name or company is present.

{
  "name": "Sarah Chen",
  "email": "sarah@weka.vc",
  "company": "Weka Ventures",
  "title": "Partner",
  "notes": "Met at Demo Day. Lead on early-stage."
}

Sync up to 100 contacts in one call. Returns { created, updated, skipped, errors, total }. Perfect for "new row in Sheets → push to Miles" Zapier flows.

{ "contacts": [
  { "name": "Sarah Chen", "email": "sarah@weka.vc" },
  { "name": "Bill Barry", "email": "bill@modius.com", "title": "CEO" }
]}

Paginated search. q matches across name / email / company / notes.

Fetch one contact by id.

Create a task. Required: title. Validated horizon: right_now | short_term | horizon. Validated status: pending | in_progress | completed | cancelled.

{
  "title": "Send pricing proposal to Sarah",
  "horizon": "right_now",
  "dueDate": "2026-05-12",
  "description": "Per the Vectris call — needs the per-seat tier laid out."
}

List tasks. Filter by horizon and/or status.

Upsert a memory by (userId, key). Required: category, key, value.

{
  "category": "preference",
  "key": "preferred_meeting_time",
  "value": "Mornings before 11am"
}

Search memory. q matches across key and value.

Delete a memory entry by id.

Every decision Miles has captured. Each has topic, decision, context, and the source meeting.

Lists every sprint (active / planned / completed) with task and done counts.

Full detail with stages and tasks. Each task carries its stageId, priority, blocked reason, due date, and assignee.

Runs a Gmail query against the user's full inbox (no time window). Returns matched threads. Auto-prefixes in:inbox, falls back to recent emails when nothing matches.

Returns 412 if the user hasn't connected Gmail. For an AI-summarized answer instead of raw threads, use /v1/ask.

{ "query": "from:sarah pricing", "limit": 15 }

Generates a fresh daily briefing via Claude. Returns the structured briefing (greeting, narrative, attentionItems, suggestedActions) plus the events / emails / pending actions it was composed from.

Activity log feed. Common action values: briefing_generated, transcript_processed, task_created, email_sent, meeting_prepped, action_executed.