OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

meeting-recorder.fireflies

Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.integrations
  • Tags: meeting-recorder, fireflies, transcripts
  • field.key.label
    meeting-recorder.fireflies
    field.version.label
    1.0.0
    field.type.label
    integration (integration)
    field.title.label
    meeting-recorder.fireflies
    field.description.label

    Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.integrations
  • Tags: meeting-recorder, fireflies, transcripts
  • field.tags.label
    meeting-recorder,fireflies,transcripts
    field.owners.label
    platform.integrations
    field.stability.label

    Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.

    Source Definition

    export const firefliesIntegrationSpec = defineIntegration({
      meta: {
        key: 'meeting-recorder.fireflies',
        version: '1.0.0',
        category: 'meeting-recorder',
        title: 'Fireflies.ai Meeting Recorder',
        description:
          'Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.',
        domain: 'productivity',
        owners: ['platform.integrations'],
        tags: ['meeting-recorder', 'fireflies', 'transcripts'],
        stability: StabilityEnum.Experimental,
      },
      supportedModes: ['byok'],
      capabilities: {
        provides: [
          { key: 'meeting-recorder.meetings.read', version: '1.0.0' },
          { key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
          { key: 'meeting-recorder.webhooks', version: '1.0.0' },
        ],
      },
      configSchema: {
        schema: {
          type: 'object',
          properties: {
            baseUrl: {
              type: 'string',
              description:
                'Optional override for the Fireflies GraphQL endpoint. Defaults to https://api.fireflies.ai/graphql.',
            },
            webhookUrl: {
              type: 'string',
              description:
                'Webhook destination URL configured in Fireflies developer settings.',
            },
            webhookEvents: {
              type: 'array',
              items: { type: 'string' },
              description:
                'Webhook events to subscribe to (e.g., Transcription completed).',
            },
            transcriptsPageSize: {
              type: 'number',
              description: 'Number of transcripts to request per GraphQL query.',
            },
          },
        },
        example: {
          baseUrl: 'https://api.fireflies.ai/graphql',
          webhookUrl: 'https://example.com/webhooks/fireflies',
          webhookEvents: ['Transcription completed'],
          transcriptsPageSize: 25,
        },
      },
      secretSchema: {
        schema: {
          type: 'object',
          required: ['apiKey'],
          properties: {
            apiKey: {
              type: 'string',
              description: 'Fireflies API key for GraphQL requests.',
            },
            webhookSecret: {
              type: 'string',
              description:
                'Optional webhook secret used to verify x-hub-signature HMAC payloads.',
            },
          },
        },
        example: {
          apiKey: 'fireflies-***',
          webhookSecret: 'fireflies-webhook-secret',
        },
      },
      healthCheck: {
        method: 'custom',
        timeoutMs: 6000,
      },
      docsUrl: 'https://docs.fireflies.ai/getting-started/introduction',
      byokSetup: {
        setupInstructions:
          'Create a Fireflies API key and optionally configure webhook settings in Developer Settings.',
      },
    });