Agentic Endpoints Meetings API

openapi: 3.2.0
info:
  title: agentic-endpoints Meetings API
  version: 1.0.0
  license:
    name: MIT
    identifier: MIT
  description: 'Pay-per-call utilities for autonomous agents. No signup, no API keys, no invoices: every endpoint answers HTTP 402 with a price and serves the request once payment is signed.'
servers:
- url: https://agentic-endpoints.com
tags:
- name: Meetings
paths:
  /meetings/import:
    post:
      summary: Import a meeting transcript.
      description: Import a meeting transcript. Accepts a raw WebVTT or SRT export straight from Zoom, Teams, Meet or a notetaker -- timestamps and cue numbering are stripped so search matches phrases the export split across cues. visibility "private" stores ciphertext this service cannot read; "queryable" stores plaintext and indexes it for search. The first import claims the namespace and returns a one-time namespace_token.. Costs $0.010, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_import
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                title:
                  type: string
                  description: Human-readable meeting title
                occurred_at:
                  type: string
                  description: ISO-8601 time the meeting happened
                source:
                  type: string
                  description: 'Optional hint about the export format. Ignored if it disagrees with the file: WebVTT and SRT are detected from the content itself, unpacked into speaker-attributed text, and any speakers found are added to participants. Plain text is stored verbatim.'
                visibility:
                  type: string
                  description: Required choice. "queryable" = plaintext transcript, searchable, readable by this service. "private" (default) = ciphertext you encrypted, never searchable. Sending the wrong field for the mode is refused rather than guessed.
                transcript:
                  type: string
                  description: Plaintext. Only with visibility "queryable"
                ciphertext:
                  type: string
                  description: Client-side encrypted. Only with visibility "private"
                alg:
                  type: string
                  description: Encryption algorithm label for private meetings
                participants:
                  type: array
                  description: Optional list of attendees
                namespace_token:
                  type: string
                  description: Required once the namespace has been claimed
              required:
              - namespace
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              title: Pricing review
              occurred_at: '2026-01-04T15:00:00.000Z'
              source: webvtt
              visibility: queryable
              transcript: 'Alice: we agreed to ship the redesign before the audit...'
              participants:
              - Alice
              - Bob
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: imported
                meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
                visibility: queryable
                searchable: true
                size_bytes: 4820
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
  /meetings/search:
    post:
      summary: Full-text search across your queryable meetings.
      description: Full-text search across your queryable meetings. Returns ranked excerpts, and reports how many meetings were private and therefore not searched.. Costs $0.010, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                namespace_token:
                  type: string
                  description: One-time token issued when the namespace was claimed
                query:
                  type: string
                  description: 'FTS5 match expression. Quote phrases: "budget review"'
                limit:
                  type: number
                  description: Max results, 1-50 (default 10)
              required:
              - namespace
              - namespace_token
              - query
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              namespace_token: the token returned by your first import
              query: pricing
              limit: 10
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: ok
                query: pricing
                count: 1
                matches:
                - meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
                  title: Pricing review
                  excerpt: we agreed to defer the [pricing] change until Q3…
                searched_meetings: 12
                private_meetings_skipped: 3
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
  /meetings/summarize:
    post:
      summary: Ask a question in plain language and get an answer grounded in your own…
      description: Ask a question in plain language and get an answer grounded in your own meetings, with a citation to the meeting each claim came from. Retrieves the relevant transcripts and reasons over them. When nothing matches, no answer is generated rather than one being invented.. Costs $0.050, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_summarize
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                namespace_token:
                  type: string
                  description: One-time token issued when the namespace was claimed
                question:
                  type: string
                  description: A plain-language question. Not FTS5 syntax -- the search terms are derived from it and returned as `terms`.
                limit:
                  type: number
                  description: Max meetings to consult, 1-8 (default 5)
              required:
              - namespace
              - namespace_token
              - question
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              namespace_token: the token returned by your first import
              question: what did we decide about pricing?
              limit: 5
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: ok
                question: what did we decide about pricing?
                answer: You agreed to defer the pricing change until Q3 [6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11].
                consulted:
                - meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
                  title: Pricing review
                  chars_used: 4820
                  truncated: false
                terms:
                - decide
                - pricing
                ai_generated: true
                searched_meetings: 12
                private_meetings_skipped: 3
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
  /meetings/get:
    post:
      summary: Fetch one meeting in full, by meeting_id (requires the namespace_token)
      description: Fetch one meeting in full, by meeting_id (requires the namespace_token). Costs $0.005, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_get
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                namespace_token:
                  type: string
                  description: One-time token issued when the namespace was claimed
                meeting_id:
                  type: string
                  description: Returned by /meetings/import
              required:
              - namespace
              - namespace_token
              - meeting_id
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              namespace_token: the token returned by your first import
              meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: ok
                meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
                title: Pricing review
                visibility: queryable
                transcript: 'Alice: we agreed to defer the pricing change until Q3...'
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
  /meetings/list:
    post:
      summary: List the meetings in a namespace with their metadata, newest first.
      description: List the meetings in a namespace with their metadata, newest first. Never returns transcripts (requires the namespace_token). Costs $0.005, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                namespace_token:
                  type: string
                  description: One-time token issued when the namespace was claimed
                limit:
                  type: number
                  description: Max results, 1-500 (default 100)
              required:
              - namespace
              - namespace_token
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              namespace_token: the token returned by your first import
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: ok
                count: 1
                meetings:
                - meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
                  title: Pricing review
                  visibility: queryable
                  searchable: true
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
  /meetings/delete:
    post:
      summary: Delete a meeting and remove it from the search index (requires the…
      description: Delete a meeting and remove it from the search index (requires the namespace_token). Costs $0.001, paid per call with x402 (USDC on Base), or debited from a prepaid balance by sending an X-Credit-Token header.
      operationId: meetings_delete
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                namespace:
                  type: string
                  description: Meeting memory isolation scope
                namespace_token:
                  type: string
                  description: One-time token issued when the namespace was claimed
                meeting_id:
                  type: string
                  description: Returned by /meetings/import
              required:
              - namespace
              - namespace_token
              - meeting_id
            example:
              namespace: my-meetings-4f9c2b1e8d7a
              namespace_token: the token returned by your first import
              meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                status: deleted
                meeting_id: 6f1c3b90-0f6a-4c2e-9a1e-2b7d5c8e4a11
        '402':
          description: Payment required. The body names the price and all three ways to pay, including the free trial that needs no wallet. The `payment-required` response header carries the same challenge base64-encoded, which is where x402 v2 clients read it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentRequired'
        '429':
          description: Rate limited.
      security:
      - creditToken: []
      - x402Payment: []
      - {}
      tags:
      - Meetings
components:
  schemas:
    PaymentRequired:
      type: object
      description: Body of a 402. Every field is derived from the same challenge the caller is asked to sign, so it cannot quote a different price or recipient.
      properties:
        error:
          type: string
          const: payment_required
        price:
          type: string
          description: List price in dollars, e.g. $0.005
        resource:
          type: string
          description: The URL being charged for
        ways_to_pay:
          type: object
          description: The three routes in, cheapest first. free_trial needs no wallet, no signature, no account and no email.
          properties:
            free_trial:
              type: object
            prepaid_credit:
              type: object
            per_call_x402:
              type: object
        accepts:
          type: array
          description: The x402 challenge, echoed here for v1 clients that read it from the body rather than the payment-required header.
          items:
            type: object
        x402Version:
          type: number
      required:
      - error
      - ways_to_pay
  securitySchemes:
    creditToken:
      type: apiKey
      in: header
      name: X-Credit-Token
      description: A prepaid or trial balance. Get one free with no wallet and no account at POST https://agentic-endpoints.com/credits/trial, or buy credit at POST https://agentic-endpoints.com/credits/buy. Each call is debited at the route's list price and nothing is signed per request.
    x402Payment:
      type: apiKey
      in: header
      name: X-PAYMENT
      description: A signed x402 payment authorising this one call, built from the challenge returned with HTTP 402. Requires a funded wallet on Base; the credit token does not.