confcall Artifacts API

openapi: 3.2.0
info:
  title: Confcall App Artifacts API
  version: post-phase-1
  x-canonical-url: https://docs.confcall.app/openapi/confcall-control-plane.json
  description: 'Operations tagged Artifacts across 2 of this provider''s published API definitions: confcall-control-plane.json, confcall-app-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://meet.confcall.app
  description: Production
security:
- ApiKeyAuth: []
- OAuth2ClientCredentials:
  - confcall:rooms
  - confcall:history
tags:
- name: Artifacts
paths:
  /api/artifacts/{sessionId}:
    get:
      operationId: getArtifact
      summary: Get a single session's full transcript, summary, decisions, and action items
      x-auth: jwtOrApiKey
      x-scope: confcall:history
      parameters:
      - name: sessionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Artifact bundle, including provenance { aiGenerated[], aiAssisted[], generator }; keep it when republishing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArtifactBundle'
        '403':
          description: Caller has no access to this session's room
        '404':
          description: Artifact not found
      tags:
      - Artifacts
    servers:
    - url: https://meet.confcall.app
      description: Production
components:
  schemas:
    ArtifactBundle:
      type: object
      properties:
        conferenceSessionId:
          type: string
        roomId:
          type: string
        accountId:
          type:
          - string
          - 'null'
        source:
          type: string
        startedAt:
          type: string
          format: date-time
        endedAt:
          type:
          - string
          - 'null'
          format: date-time
        turns:
          type: array
          items:
            $ref: '#/components/schemas/ArtifactTurn'
        summaryText:
          type:
          - string
          - 'null'
        actionItems:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/ArtifactActionItem'
        outcome:
          type:
          - string
          - 'null'
        decisions:
          type:
          - array
          - 'null'
          items:
            type: string
        followUps:
          type:
          - array
          - 'null'
          items:
            type: string
        structuredOutput:
          description: Free-form structured output, when the session produced one
        createdAt:
          type: string
          format: date-time
        provenance:
          type: object
          description: Which parts of the bundle are AI-generated (EU AI Act Art. 50(2)); computed on read
          properties:
            aiGenerated:
              type: array
              items:
                type: string
            aiAssisted:
              type: array
              items:
                type: string
            generator:
              type: string
            notice:
              type: string
              description: Ready-to-embed attribution for exported text; empty when nothing is AI-generated
    ArtifactTurn:
      type: object
      properties:
        role:
          type: string
          enum:
          - user
          - agent
        content:
          type: string
        language:
          type:
          - string
          - 'null'
        intent:
          type:
          - string
          - 'null'
        timestamp:
          type: string
          format: date-time
    ArtifactActionItem:
      type: object
      properties:
        description:
          type: string
        assignee:
          type:
          - string
          - 'null'
        dueDate:
          type:
          - string
          - 'null'
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: A confcall secret (sk_live_/sk_test_) API key. Publishable (pk_) keys are rejected on every route documented here.
    OAuth2ClientCredentials:
      type: oauth2
      description: 'OAuth 2.0 client-credentials grant. Exchange a client id/secret at the token URL for a short-lived bearer JWT and send it as `Authorization: Bearer <token>`. Operations with x-auth jwtOrApiKey accept either this or ApiKeyAuth; x-auth jwt operations need a user-context token.'
      flows:
        clientCredentials:
          tokenUrl: https://auth.confcall.app/oauth/token
          scopes:
            confcall:rooms: Manage rooms and invite/remove the AI agent
            confcall:history: Read meeting artifacts (transcripts, summaries, action items)
x-refined-from:
- confcall-control-plane.json
- confcall-app-openapi.yml