{
  "components": {
    "responses": {
      "BadRequest": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "A parameter or the body failed validation. The error lists each field."
      },
      "Conflict": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "This automation was stopped in VoiceCap and can't be switched back on from here."
      },
      "Forbidden": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "The key is valid but may not do this: API keys are turned off for the organization, the endpoint does not accept API keys, or the account cannot use it."
      },
      "NotFound": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "Not found, or not something the key owner can open."
      },
      "RateLimited": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "Too many requests. Wait the number of seconds in Retry-After.",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before the next request.",
            "schema": {
              "minimum": 1,
              "type": "integer"
            }
          }
        }
      },
      "Unauthorized": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "The API key is missing, malformed, revoked or no longer valid."
      },
      "Unprocessable": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "description": "The event name, its filters or the target URL were refused. The error code says which."
      }
    },
    "schemas": {
      "ActionItemCreatedEvent": {
        "additionalProperties": false,
        "properties": {
          "assignee": {
            "type": [
              "string",
              "null"
            ]
          },
          "completed": {
            "type": "boolean"
          },
          "id": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "meeting": {
            "additionalProperties": false,
            "properties": {
              "completedAt": {
                "type": "string"
              },
              "id": {
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "type": "string"
              },
              "recordedAt": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "format": "uri",
                "type": "string"
              }
            },
            "required": [
              "id",
              "title",
              "recordedAt",
              "completedAt",
              "url"
            ],
            "type": "object"
          },
          "text": {
            "type": "string"
          },
          "timestamp": {
            "type": [
              "number",
              "null"
            ]
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "id",
          "text",
          "assignee",
          "completed",
          "timestamp",
          "url",
          "meeting"
        ],
        "type": "object"
      },
      "ActionItemCreatedFilters": {
        "additionalProperties": false,
        "properties": {
          "assignedToMe": {
            "description": "Only action items assigned to you (by your identified speaker in the meeting).",
            "type": "boolean"
          },
          "classification": {
            "description": "Only meetings whose attendees are all internal, or include someone external.",
            "enum": [
              "internal",
              "external",
              "any"
            ],
            "type": "string"
          },
          "groupId": {
            "description": "Only meetings filed to this group.",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "participantDomain": {
            "description": "Only meetings with an attendee from exactly this email domain.",
            "maxLength": 253,
            "minLength": 3,
            "pattern": "^(?!-)[a-z0-9-]{1,63}(?<!-)(\\.(?!-)[a-z0-9-]{1,63}(?<!-))+$",
            "type": "string"
          },
          "participantEmail": {
            "description": "Only meetings with this attendee or identified speaker.",
            "format": "email",
            "maxLength": 320,
            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "scope": {
            "description": "mine: meetings you recorded. all_visible: every meeting you can open. Defaults to your own meetings for workspace owners and admins with oversight, otherwise all_visible.",
            "enum": [
              "mine",
              "all_visible"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "ApiError": {
        "anyOf": [
          {
            "additionalProperties": false,
            "properties": {
              "errors": {
                "additionalProperties": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "propertyNames": {
                  "type": "string"
                },
                "type": "object"
              },
              "type": {
                "const": "validation",
                "type": "string"
              }
            },
            "required": [
              "type",
              "errors"
            ],
            "type": "object"
          },
          {
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "type": {
                "const": "error",
                "type": "string"
              }
            },
            "required": [
              "type",
              "message"
            ],
            "type": "object"
          }
        ]
      },
      "CreateHookRequest": {
        "properties": {
          "event": {
            "maxLength": 100,
            "minLength": 1,
            "type": "string"
          },
          "filters": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "targetUrl": {
            "maxLength": 2048,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "event",
          "targetUrl"
        ],
        "type": "object"
      },
      "CreateHookResponse": {
        "additionalProperties": false,
        "properties": {
          "created": {
            "type": "boolean"
          },
          "event": {
            "type": "string"
          },
          "filters": {
            "additionalProperties": {},
            "propertyNames": {
              "type": "string"
            },
            "type": "object"
          },
          "id": {
            "type": "string"
          },
          "secret": {
            "pattern": "^whsec_",
            "type": "string"
          }
        },
        "required": [
          "id",
          "event",
          "filters",
          "secret",
          "created"
        ],
        "type": "object"
      },
      "DecisionRecordedEvent": {
        "additionalProperties": false,
        "properties": {
          "context": {
            "type": [
              "string",
              "null"
            ]
          },
          "decidedBy": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "meeting": {
            "additionalProperties": false,
            "properties": {
              "completedAt": {
                "type": "string"
              },
              "id": {
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "type": "string"
              },
              "recordedAt": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "format": "uri",
                "type": "string"
              }
            },
            "required": [
              "id",
              "title",
              "recordedAt",
              "completedAt",
              "url"
            ],
            "type": "object"
          },
          "statement": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "id",
          "statement",
          "context",
          "decidedBy",
          "url",
          "meeting"
        ],
        "type": "object"
      },
      "DecisionRecordedFilters": {
        "additionalProperties": false,
        "properties": {
          "classification": {
            "description": "Only meetings whose attendees are all internal, or include someone external.",
            "enum": [
              "internal",
              "external",
              "any"
            ],
            "type": "string"
          },
          "groupId": {
            "description": "Only meetings filed to this group.",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "participantDomain": {
            "description": "Only meetings with an attendee from exactly this email domain.",
            "maxLength": 253,
            "minLength": 3,
            "pattern": "^(?!-)[a-z0-9-]{1,63}(?<!-)(\\.(?!-)[a-z0-9-]{1,63}(?<!-))+$",
            "type": "string"
          },
          "participantEmail": {
            "description": "Only meetings with this attendee or identified speaker.",
            "format": "email",
            "maxLength": 320,
            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "scope": {
            "description": "mine: meetings you recorded. all_visible: every meeting you can open. Defaults to your own meetings for workspace owners and admins with oversight, otherwise all_visible.",
            "enum": [
              "mine",
              "all_visible"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "DeleteHookResponse": {
        "additionalProperties": false,
        "properties": {
          "deleted": {
            "const": true,
            "type": "boolean"
          }
        },
        "required": [
          "deleted"
        ],
        "type": "object"
      },
      "ErrorEnvelope": {
        "additionalProperties": false,
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ApiError"
          },
          "success": {
            "const": false,
            "type": "boolean"
          }
        },
        "required": [
          "success",
          "error"
        ],
        "type": "object"
      },
      "GetMeResponse": {
        "additionalProperties": false,
        "properties": {
          "memberSince": {
            "type": "string"
          },
          "org": {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "domain": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "id": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "slug",
                  "domain"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "role": {
            "anyOf": [
              {
                "enum": [
                  "owner",
                  "admin",
                  "member",
                  "viewer"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "user": {
            "additionalProperties": false,
            "properties": {
              "email": {
                "format": "email",
                "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
                "type": "string"
              },
              "emailVerified": {
                "type": "boolean"
              },
              "id": {
                "minLength": 1,
                "type": "string"
              },
              "image": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "id",
              "email",
              "name",
              "emailVerified"
            ],
            "type": "object"
          }
        },
        "required": [
          "user",
          "org",
          "role"
        ],
        "type": "object"
      },
      "GetMeetingResponse": {
        "additionalProperties": false,
        "properties": {
          "audioDurationSeconds": {
            "type": [
              "number",
              "null"
            ]
          },
          "calendarEventId": {
            "anyOf": [
              {
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "canDelete": {
            "type": "boolean"
          },
          "canDownload": {
            "type": "boolean"
          },
          "canEdit": {
            "type": "boolean"
          },
          "canShare": {
            "type": "boolean"
          },
          "createdAt": {
            "type": "string"
          },
          "errorMessage": {
            "anyOf": [
              {
                "const": "processing_failed",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "files": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "createdAt": {
                  "type": "string"
                },
                "durationSeconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "errorMessage": {
                  "anyOf": [
                    {
                      "const": "processing_failed",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "fileName": {
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "meetingId": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "speakers": {
                  "anyOf": [
                    {
                      "additionalProperties": {
                        "type": "string"
                      },
                      "propertyNames": {
                        "type": "string"
                      },
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "status": {
                  "enum": [
                    "uploading",
                    "pending",
                    "processing",
                    "completed",
                    "failed"
                  ],
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "meetingId",
                "fileName",
                "durationSeconds",
                "language",
                "status",
                "speakers",
                "errorMessage",
                "createdAt",
                "updatedAt"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "id": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "linkEnabled": {
            "type": "boolean"
          },
          "participantEmailMode": {
            "anyOf": [
              {
                "enum": [
                  "none",
                  "internal",
                  "all"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "recordedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "sharedWithOrg": {
            "type": "boolean"
          },
          "status": {
            "enum": [
              "uploading",
              "pending",
              "recording",
              "processing",
              "summarizing",
              "completed",
              "failed"
            ],
            "type": "string"
          },
          "summary": {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "actionItems": {
                    "anyOf": [
                      {
                        "items": {
                          "additionalProperties": false,
                          "properties": {
                            "assignee": {
                              "type": "string"
                            },
                            "completed": {
                              "type": "boolean"
                            },
                            "id": {
                              "type": "string"
                            },
                            "text": {
                              "type": "string"
                            },
                            "timestamp": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "text",
                            "completed"
                          ],
                          "type": "object"
                        },
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "keyTopics": {
                    "anyOf": [
                      {
                        "anyOf": [
                          {
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          {
                            "items": {
                              "additionalProperties": false,
                              "properties": {
                                "endTimestamp": {
                                  "type": "number"
                                },
                                "speakers": {
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                },
                                "summary": {
                                  "type": "string"
                                },
                                "timestamp": {
                                  "type": "number"
                                },
                                "title": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "title",
                                "timestamp",
                                "summary"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          }
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "summary": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "summary",
                  "actionItems",
                  "keyTopics"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": "string"
          },
          "transcript": {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "fullText": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "omitted": {
                    "type": "boolean"
                  },
                  "segments": {
                    "anyOf": [
                      {
                        "items": {
                          "additionalProperties": false,
                          "properties": {
                            "end": {
                              "type": "number"
                            },
                            "speaker": {
                              "type": "string"
                            },
                            "start": {
                              "type": "number"
                            },
                            "text": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "speaker",
                            "text",
                            "start",
                            "end"
                          ],
                          "type": "object"
                        },
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "speakers": {
                    "anyOf": [
                      {
                        "additionalProperties": {
                          "type": "string"
                        },
                        "propertyNames": {
                          "type": "string"
                        },
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "fullText",
                  "segments",
                  "speakers",
                  "omitted"
                ],
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "updatedAt": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "createdAt",
          "audioDurationSeconds",
          "status",
          "sharedWithOrg",
          "linkEnabled",
          "userId",
          "language",
          "errorMessage",
          "updatedAt",
          "canEdit",
          "canDelete",
          "canDownload",
          "canShare",
          "transcript",
          "summary",
          "participantEmailMode",
          "files"
        ],
        "type": "object"
      },
      "GetMeetingTranscriptResponse": {
        "additionalProperties": false,
        "properties": {
          "durationSeconds": {
            "type": [
              "number",
              "null"
            ]
          },
          "endSeconds": {
            "type": "number"
          },
          "meetingId": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "nextStartSeconds": {
            "type": [
              "number",
              "null"
            ]
          },
          "segments": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "end": {
                  "type": "number"
                },
                "speaker": {
                  "type": "string"
                },
                "start": {
                  "type": "number"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "speaker",
                "text",
                "start",
                "end"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "speakers": {
            "anyOf": [
              {
                "additionalProperties": {
                  "type": "string"
                },
                "propertyNames": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ]
          },
          "startSeconds": {
            "type": "number"
          }
        },
        "required": [
          "meetingId",
          "durationSeconds",
          "startSeconds",
          "endSeconds",
          "segments",
          "speakers",
          "nextStartSeconds"
        ],
        "type": "object"
      },
      "ListActionItemsResponse": {
        "additionalProperties": false,
        "properties": {
          "actionItems": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "assignee": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "completed": {
                  "type": "boolean"
                },
                "completedAt": {
                  "type": "string"
                },
                "id": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "meetingDate": {
                  "type": "string"
                },
                "meetingId": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "meetingTitle": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "timestamp": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "text",
                "assignee",
                "completed",
                "timestamp",
                "meetingId",
                "meetingTitle",
                "meetingDate",
                "completedAt",
                "url"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "hasMore": {
            "type": "boolean"
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "actionItems",
          "hasMore",
          "truncated"
        ],
        "type": "object"
      },
      "ListDecisionsResponse": {
        "additionalProperties": false,
        "properties": {
          "decisions": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "context": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "createdAt": {
                  "type": "string"
                },
                "decidedBy": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "id": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "meetingDate": {
                  "type": "string"
                },
                "meetingId": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "meetingTitle": {
                  "type": "string"
                },
                "statement": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "statement",
                "context",
                "decidedBy",
                "meetingId",
                "meetingTitle",
                "meetingDate",
                "createdAt",
                "url"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "hasMore": {
            "type": "boolean"
          }
        },
        "required": [
          "decisions",
          "hasMore"
        ],
        "type": "object"
      },
      "ListGroupsResponse": {
        "additionalProperties": false,
        "properties": {
          "groups": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "canEdit": {
                  "type": "boolean"
                },
                "companyWide": {
                  "type": "boolean"
                },
                "createdBy": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "id": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "isMember": {
                  "type": "boolean"
                },
                "memberCount": {
                  "maximum": 9007199254740991,
                  "minimum": 0,
                  "type": "integer"
                },
                "memberIds": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                "name": {
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name",
                "memberIds",
                "memberCount"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "hasMore": {
            "type": "boolean"
          }
        },
        "required": [
          "groups"
        ],
        "type": "object"
      },
      "ListHooksResponse": {
        "additionalProperties": false,
        "properties": {
          "hooks": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "createdAt": {
                  "type": "string"
                },
                "event": {
                  "type": "string"
                },
                "filters": {
                  "additionalProperties": {},
                  "propertyNames": {
                    "type": "string"
                  },
                  "type": "object"
                },
                "id": {
                  "type": "string"
                },
                "lastDeliveryAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "lastErrorCategory": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "active",
                    "suspended",
                    "expired",
                    "revoked"
                  ],
                  "type": "string"
                },
                "statusReason": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "targetHost": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "event",
                "filters",
                "targetHost",
                "status",
                "statusReason",
                "lastDeliveryAt",
                "lastErrorCategory",
                "createdAt"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "hooks"
        ],
        "type": "object"
      },
      "ListMeetingsResponse": {
        "additionalProperties": false,
        "properties": {
          "hasMore": {
            "type": "boolean"
          },
          "meetings": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "actionItemsCount": {
                  "type": "number"
                },
                "audioDurationSeconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "createdAt": {
                  "type": "string"
                },
                "errorMessage": {
                  "anyOf": [
                    {
                      "const": "processing_failed",
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "id": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "linkEnabled": {
                  "type": "boolean"
                },
                "recordedAt": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "sharedWithGroups": {
                  "type": "boolean"
                },
                "sharedWithOrg": {
                  "type": "boolean"
                },
                "sharedWithPeople": {
                  "type": "boolean"
                },
                "status": {
                  "enum": [
                    "uploading",
                    "pending",
                    "recording",
                    "processing",
                    "summarizing",
                    "completed",
                    "failed"
                  ],
                  "type": "string"
                },
                "summaryPreview": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": "string"
                },
                "updatedAt": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "title",
                "createdAt",
                "updatedAt",
                "audioDurationSeconds",
                "status",
                "sharedWithOrg",
                "linkEnabled",
                "sharedWithPeople",
                "sharedWithGroups",
                "errorMessage",
                "summaryPreview",
                "actionItemsCount"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "totalCount": {
            "type": "number"
          }
        },
        "required": [
          "meetings",
          "totalCount",
          "hasMore"
        ],
        "type": "object"
      },
      "MeetingCompletedEvent": {
        "additionalProperties": false,
        "properties": {
          "actionItems": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "assignee": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "completed": {
                  "type": "boolean"
                },
                "id": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "text",
                "assignee",
                "completed"
              ],
              "type": "object"
            },
            "maxItems": 200,
            "type": "array"
          },
          "classification": {
            "enum": [
              "internal",
              "external",
              "unknown"
            ],
            "type": "string"
          },
          "completedAt": {
            "type": "string"
          },
          "counts": {
            "additionalProperties": false,
            "properties": {
              "actionItems": {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              "decisions": {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "actionItems",
              "decisions"
            ],
            "type": "object"
          },
          "decisions": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "decidedBy": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "id": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "statement": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "statement",
                "decidedBy"
              ],
              "type": "object"
            },
            "maxItems": 200,
            "type": "array"
          },
          "durationSeconds": {
            "anyOf": [
              {
                "maximum": 9007199254740991,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "groups": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "name"
              ],
              "type": "object"
            },
            "maxItems": 20,
            "type": "array"
          },
          "id": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "keyTopics": {
            "items": {
              "type": "string"
            },
            "maxItems": 30,
            "type": "array"
          },
          "language": {
            "type": [
              "string",
              "null"
            ]
          },
          "meetingId": {
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "participants": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "email": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "name": {
                  "type": "string"
                }
              },
              "required": [
                "name",
                "email"
              ],
              "type": "object"
            },
            "maxItems": 50,
            "type": "array"
          },
          "recordedAt": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "summaryExcerpt": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "format": "uri",
            "type": "string"
          }
        },
        "required": [
          "meetingId",
          "title",
          "recordedAt",
          "completedAt",
          "durationSeconds",
          "language",
          "classification",
          "participants",
          "groups",
          "url",
          "summaryExcerpt",
          "counts",
          "id",
          "summary",
          "keyTopics",
          "actionItems",
          "decisions"
        ],
        "type": "object"
      },
      "MeetingCompletedFilters": {
        "additionalProperties": false,
        "properties": {
          "classification": {
            "description": "Only meetings whose attendees are all internal, or include someone external.",
            "enum": [
              "internal",
              "external",
              "any"
            ],
            "type": "string"
          },
          "groupId": {
            "description": "Only meetings filed to this group.",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
            "type": "string"
          },
          "participantDomain": {
            "description": "Only meetings with an attendee from exactly this email domain.",
            "maxLength": 253,
            "minLength": 3,
            "pattern": "^(?!-)[a-z0-9-]{1,63}(?<!-)(\\.(?!-)[a-z0-9-]{1,63}(?<!-))+$",
            "type": "string"
          },
          "participantEmail": {
            "description": "Only meetings with this attendee or identified speaker.",
            "format": "email",
            "maxLength": 320,
            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
            "type": "string"
          },
          "scope": {
            "description": "mine: meetings you recorded. all_visible: every meeting you can open. Defaults to your own meetings for workspace owners and admins with oversight, otherwise all_visible.",
            "enum": [
              "mine",
              "all_visible"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "SampleHookEventsResponse": {
        "additionalProperties": false,
        "properties": {
          "hasMore": {
            "type": "boolean"
          },
          "items": {
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/MeetingCompletedEvent"
                },
                {
                  "$ref": "#/components/schemas/DecisionRecordedEvent"
                },
                {
                  "$ref": "#/components/schemas/ActionItemCreatedEvent"
                }
              ]
            },
            "type": "array"
          },
          "nextCursor": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "items",
          "nextCursor",
          "hasMore"
        ],
        "type": "object"
      },
      "SearchResponse": {
        "additionalProperties": false,
        "properties": {
          "hasMore": {
            "type": "boolean"
          },
          "query": {
            "type": "string"
          },
          "results": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "durationSeconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "headline": {
                  "type": "string"
                },
                "meetingDate": {
                  "type": "string"
                },
                "meetingId": {
                  "format": "uuid",
                  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                  "type": "string"
                },
                "meetingTitle": {
                  "type": "string"
                },
                "source": {
                  "enum": [
                    "transcript",
                    "summary",
                    "decision"
                  ],
                  "type": "string"
                },
                "startSeconds": {
                  "type": [
                    "number",
                    "null"
                  ]
                },
                "status": {
                  "enum": [
                    "uploading",
                    "pending",
                    "recording",
                    "processing",
                    "summarizing",
                    "completed",
                    "failed"
                  ],
                  "type": "string"
                },
                "url": {
                  "type": "string"
                }
              },
              "required": [
                "meetingId",
                "meetingTitle",
                "meetingDate",
                "durationSeconds",
                "status",
                "headline"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "total": {
            "type": "number"
          }
        },
        "required": [
          "results",
          "total",
          "query"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "apiKey": {
        "bearerFormat": "vc_live_…",
        "description": "A personal API key from Settings > Profile in VoiceCap.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Read meetings, decisions and action items from VoiceCap, and get told when a meeting is ready.\n\nAuthenticate with a personal API key as a bearer token. A key acts as the person who created it, in one organization, and sees exactly what they can open.\n\nEvery JSON response is an envelope: { \"success\": true, \"data\": … } or { \"success\": false, \"error\": … }.\n\nEach key may make 120 requests per minute and 10,000 per day, and all of one person's keys together 240 requests per minute and 20,000 per day. Over any of them, the answer is 429 with Retry-After.\n\nWebhook deliveries that fail are tried again for about 21 hours. Answer 410 to stop a subscription.",
    "title": "VoiceCap API",
    "version": "1"
  },
  "openapi": "3.1.0",
  "paths": {
    "/action-items": {
      "get": {
        "description": "Action items from meetings the key owner can open, from the meeting that finished processing most recently first. For older items, narrow with since or meetingId rather than paging far back. At most 200 items are read from any one meeting; Get a meeting returns its full list.",
        "operationId": "listActionItems",
        "parameters": [
          {
            "description": "How many to return, 1 to 100. Defaults to 25.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "How many to skip, up to 1000. Defaults to 0.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "maximum": 1000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Only items from this meeting.",
            "in": "query",
            "name": "meetingId",
            "required": false,
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "description": "Only items from meetings that finished processing after this instant. ISO 8601 with a time zone, such as 2026-10-01T09:00:00Z.",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "type": "string"
            }
          },
          {
            "description": "true for only the items assigned to the key owner.",
            "in": "query",
            "name": "assignedToMe",
            "required": false,
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string"
            }
          },
          {
            "description": "true for only done items, false for only open ones.",
            "in": "query",
            "name": "completed",
            "required": false,
            "schema": {
              "enum": [
                "true",
                "false"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ListActionItemsResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "List action items",
        "tags": [
          "Action items"
        ]
      }
    },
    "/decisions": {
      "get": {
        "description": "Decisions from meetings the key owner can open, newest first.",
        "operationId": "listDecisions",
        "parameters": [
          {
            "description": "How many to return, 1 to 100. Defaults to 25.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "How many to skip, up to 1000. Defaults to 0.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "maximum": 1000,
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Only decisions from this meeting.",
            "in": "query",
            "name": "meetingId",
            "required": false,
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          },
          {
            "description": "Only decisions recorded after this instant. ISO 8601 with a time zone, such as 2026-10-01T09:00:00Z.",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "type": "string"
            }
          },
          {
            "description": "Only decisions whose statement or context contains this text, ignoring case.",
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "maxLength": 500,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "Only decisions from meetings filed to this group. The key owner must belong to the group, unless they can see every meeting; any other group answers 404.",
            "in": "query",
            "name": "groupId",
            "required": false,
            "schema": {
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ListDecisionsResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "List decisions",
        "tags": [
          "Decisions"
        ]
      }
    },
    "/groups": {
      "get": {
        "description": "Groups the key owner can see. Without limit and offset, every group comes back and hasMore is left out. An admin sees every group, but filtering by one needs membership in it unless they can see every meeting: isMember says which groups they belong to.",
        "operationId": "listGroups",
        "parameters": [
          {
            "description": "How many to return, 1 to 100. Without it, every result comes back.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "How many to skip. Defaults to 0.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "maximum": 1000,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ListGroupsResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "List groups",
        "tags": [
          "Groups"
        ]
      }
    },
    "/hooks": {
      "get": {
        "description": "The subscriptions this key created. Only the host of each URL is shown, never the full URL. Only an API key can call this endpoint.",
        "operationId": "listHooks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ListHooksResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "List webhooks",
        "tags": [
          "Webhooks"
        ]
      },
      "post": {
        "description": "Sends an event to your HTTPS URL each time it happens. Before the subscription starts, VoiceCap sends a signed test request with a challenge your endpoint must answer with: reply with only {\"challenge\": \"…\"}, never the whole request. The response holds the signing secret, shown only here. Subscribing the same event, URL and filters again with the same key returns the existing subscription with a new secret. While it is active the old secret keeps working for 24 hours; a suspended one is checked again and switches to the new secret at once. Only an API key can call this endpoint.",
        "operationId": "createHook",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateHookRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/CreateHookResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "422": {
            "$ref": "#/components/responses/Unprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Subscribe a webhook",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "/hooks/sample": {
      "get": {
        "description": "Events exactly like the data of a delivery, up to 10 per call. Without since or cursor: the newest, newest first, to test a subscription. With either: oldest first from that point, for polling instead of subscribing. Pass nextCursor back as cursor on the next call, and call again at once while hasMore is true, so no event is missed. Only an API key can call this endpoint.",
        "operationId": "sampleHookEvents",
        "parameters": [
          {
            "description": "The event name: meeting.completed, decision.recorded or action_item.created.",
            "in": "query",
            "name": "event",
            "required": true,
            "schema": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "Only events after this instant. ISO 8601 with a time zone, such as 2026-10-01T09:00:00Z.",
            "in": "query",
            "name": "since",
            "required": false,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "type": "string"
            }
          },
          {
            "description": "The nextCursor from the previous call. Polling resumes exactly after it. Wins over since.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "maxLength": 1024,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "How many to return, 1 to 10. Defaults to 10.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "maximum": 10,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "The same filters a subscription takes, one query parameter each, such as scope=mine or assignedToMe=true.",
            "explode": true,
            "in": "query",
            "name": "filters",
            "required": false,
            "schema": {
              "additionalProperties": {
                "maxLength": 320,
                "type": "string"
              },
              "type": "object"
            },
            "style": "form"
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SampleHookEventsResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "422": {
            "$ref": "#/components/responses/Unprocessable"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Get recent events",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "/hooks/{id}": {
      "delete": {
        "description": "Stops a subscription this key created. Always answers deleted: true, including for an id that is already gone or belongs to someone else, so it is safe to repeat. Only an API key can call this endpoint.",
        "operationId": "deleteHook",
        "parameters": [
          {
            "description": "The subscription id from Subscribe a webhook.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/DeleteHookResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Unsubscribe a webhook",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "/me": {
      "get": {
        "description": "The person the key acts as and their organization. Use it to test a key and to label a connection.",
        "operationId": "getMe",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/GetMeResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Get the key owner",
        "tags": [
          "Account"
        ]
      }
    },
    "/meetings": {
      "get": {
        "description": "Meetings the key owner can open, newest first by default. Paged by page number.",
        "operationId": "listMeetings",
        "parameters": [
          {
            "description": "Page number, from 1. Defaults to 1.",
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991,
              "type": "integer"
            }
          },
          {
            "description": "How many to return, 1 to 100. Defaults to 20.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "exclusiveMinimum": 0,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "date (when the meeting happened), title, duration, or completedAt (when it finished processing). Defaults to date.",
            "in": "query",
            "name": "sortBy",
            "required": false,
            "schema": {
              "default": "date",
              "enum": [
                "date",
                "title",
                "duration",
                "completedAt"
              ],
              "type": "string"
            }
          },
          {
            "description": "asc or desc. Defaults to desc.",
            "in": "query",
            "name": "sortOrder",
            "required": false,
            "schema": {
              "default": "desc",
              "enum": [
                "asc",
                "desc"
              ],
              "type": "string"
            }
          },
          {
            "description": "all, completed, processing or failed. Defaults to all.",
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "completed",
                "processing",
                "failed"
              ],
              "type": "string"
            }
          },
          {
            "description": "Only meetings on or after this day, as YYYY-MM-DD.",
            "in": "query",
            "name": "dateFrom",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only meetings on or before this day, as YYYY-MM-DD.",
            "in": "query",
            "name": "dateTo",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only meetings whose title or transcript mentions this text.",
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Only completed meetings that finished processing after this instant. ISO 8601 with a time zone.",
            "in": "query",
            "name": "completedAfter",
            "required": false,
            "schema": {
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/ListMeetingsResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "List meetings",
        "tags": [
          "Meetings"
        ]
      }
    },
    "/meetings/{id}": {
      "get": {
        "description": "One meeting with its summary, action items, key topics and transcript. A meeting the key owner cannot open answers 404. A transcript too long to include (a recording many hours long) comes back with omitted: true and no text: read it with Get a transcript section.",
        "operationId": "getMeeting",
        "parameters": [
          {
            "description": "The meeting id.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/GetMeetingResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Get a meeting",
        "tags": [
          "Meetings"
        ]
      }
    },
    "/meetings/{id}/export": {
      "get": {
        "description": "The meeting as a file: PDF, Word, plain text or subtitles. A successful answer is the file itself, not JSON. Errors use the usual error body; srt of a meeting with no transcript answers 404 no_transcript.",
        "operationId": "exportMeeting",
        "parameters": [
          {
            "description": "The meeting id.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "pdf, docx, txt or srt.",
            "in": "query",
            "name": "format",
            "required": true,
            "schema": {
              "enum": [
                "pdf",
                "docx",
                "txt",
                "srt"
              ],
              "type": "string"
            }
          },
          {
            "description": "Comma-separated: summary, actionItems, keyTopics, transcript. Defaults to all of them. srt is always the transcript only.",
            "in": "query",
            "name": "sections",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/pdf": {
                "schema": {
                  "contentMediaType": "application/pdf",
                  "type": "string"
                }
              },
              "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "contentMediaType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
                  "type": "string"
                }
              },
              "application/x-subrip; charset=utf-8": {
                "schema": {
                  "contentMediaType": "application/x-subrip; charset=utf-8",
                  "type": "string"
                }
              },
              "text/plain; charset=utf-8": {
                "schema": {
                  "contentMediaType": "text/plain; charset=utf-8",
                  "type": "string"
                }
              }
            },
            "description": "The file.",
            "headers": {
              "Content-Disposition": {
                "description": "attachment, with the file name.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Export a meeting",
        "tags": [
          "Meetings"
        ]
      }
    },
    "/meetings/{id}/transcript": {
      "get": {
        "description": "The transcript in sections of up to 15 minutes, for reading a meeting of any length. Start with startSeconds 0 and pass nextStartSeconds back as startSeconds until it is null: every segment comes back exactly once. A very dense stretch can end a section early. A meeting without a transcript answers 404 no_transcript.",
        "operationId": "getMeetingTranscript",
        "parameters": [
          {
            "description": "The meeting id.",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Where the section starts, in seconds from the beginning of the recording. Defaults to 0.",
            "in": "query",
            "name": "startSeconds",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/GetMeetingTranscriptResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Get a transcript section",
        "tags": [
          "Meetings"
        ]
      }
    },
    "/search": {
      "get": {
        "description": "Searches what was said in meetings the key owner can open. The same search as in the app.",
        "operationId": "search",
        "parameters": [
          {
            "description": "What to search for, up to 500 characters.",
            "in": "query",
            "name": "q",
            "required": true,
            "schema": {
              "maxLength": 500,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "description": "How many to return, 1 to 100. Defaults to 20.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "exclusiveMinimum": 0,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "How many to skip, up to 118. Defaults to 0.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "maximum": 118,
              "minimum": 0,
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": false,
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/SearchResponse"
                    },
                    "success": {
                      "const": true,
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "success",
                    "data"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "OK"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "summary": "Search meetings",
        "tags": [
          "Search"
        ]
      }
    }
  },
  "security": [
    {
      "apiKey": []
    }
  ],
  "servers": [
    {
      "url": "https://voicecap.ai/api/v1"
    }
  ],
  "tags": [
    {
      "name": "Account"
    },
    {
      "name": "Meetings"
    },
    {
      "name": "Search"
    },
    {
      "name": "Decisions"
    },
    {
      "name": "Action items"
    },
    {
      "name": "Groups"
    },
    {
      "name": "Webhooks"
    }
  ],
  "webhooks": {
    "action_item.created": {
      "post": {
        "description": "One event per action item in the summary of a meeting that just finished processing, sent once. Items added by hand later are not sent. Subscribe with event action_item.created; its filters are ActionItemCreatedFilters.",
        "operationId": "onActionItemCreated",
        "parameters": [
          {
            "description": "The event id, the same as eventId in the body. Use it to drop duplicates.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "When this attempt was signed, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Standard Webhooks signature: space-separated v1,<base64> values. Verify it with the whsec_ secret from Subscribe a webhook.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The subscription this delivery belongs to.",
            "in": "header",
            "name": "X-VoiceCap-Subscription-Id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "cursor": null,
                "data": {
                  "assignee": "Sam Lee",
                  "completed": false,
                  "id": "9b2e4d6f-1a3c-4b5d-8e7f-0a1b2c3d4e5f",
                  "meeting": {
                    "completedAt": "2026-10-14T10:07:12.000Z",
                    "id": "0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f",
                    "recordedAt": "2026-10-14T09:00:00.000Z",
                    "title": "Quarterly planning with Acme",
                    "url": "https://voicecap.ai/meetings/0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f"
                  },
                  "text": "Send the contract draft to Acme",
                  "timestamp": 2915,
                  "url": "https://voicecap.ai/meetings/0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f?t=2915"
                },
                "eventId": "8f0a2b3c-4d5e-4f6a-9b7c-8d9e0f1a2b3c",
                "name": "action_item.created",
                "timestamp": "2026-10-14T10:07:12.000Z"
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "cursor": {
                    "type": "null"
                  },
                  "data": {
                    "$ref": "#/components/schemas/ActionItemCreatedEvent"
                  },
                  "eventId": {
                    "description": "Unique per event. Repeated attempts carry the same id.",
                    "type": "string"
                  },
                  "name": {
                    "const": "action_item.created",
                    "type": "string"
                  },
                  "timestamp": {
                    "description": "When the event happened.",
                    "format": "date-time",
                    "type": "string"
                  }
                },
                "required": [
                  "eventId",
                  "name",
                  "timestamp",
                  "data",
                  "cursor"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "410": {
            "description": "Gone: VoiceCap stops this subscription and sends it nothing more."
          },
          "2XX": {
            "description": "Received. Answer within 10 seconds; the body is ignored."
          }
        },
        "security": [],
        "summary": "Action item created",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "decision.recorded": {
      "post": {
        "description": "One event per decision in a meeting that just finished processing, sent once. Subscribe with event decision.recorded; its filters are DecisionRecordedFilters.",
        "operationId": "onDecisionRecorded",
        "parameters": [
          {
            "description": "The event id, the same as eventId in the body. Use it to drop duplicates.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "When this attempt was signed, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Standard Webhooks signature: space-separated v1,<base64> values. Verify it with the whsec_ secret from Subscribe a webhook.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The subscription this delivery belongs to.",
            "in": "header",
            "name": "X-VoiceCap-Subscription-Id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "cursor": null,
                "data": {
                  "context": "Acme needs time to pick the second team before the pilot starts.",
                  "decidedBy": "Alex Morgan",
                  "id": "6a1f3c2e-9d4b-4e8a-b7c5-1f2e3d4c5b6a",
                  "meeting": {
                    "completedAt": "2026-10-14T10:07:12.000Z",
                    "id": "0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f",
                    "recordedAt": "2026-10-14T09:00:00.000Z",
                    "title": "Quarterly planning with Acme",
                    "url": "https://voicecap.ai/meetings/0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f"
                  },
                  "statement": "Start the pilot in November with two teams",
                  "url": "https://voicecap.ai/meetings/0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f?t=1260"
                },
                "eventId": "7e9f1a2b-3c4d-4e5f-8a6b-7c8d9e0f1a2b",
                "name": "decision.recorded",
                "timestamp": "2026-10-14T10:07:12.000Z"
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "cursor": {
                    "type": "null"
                  },
                  "data": {
                    "$ref": "#/components/schemas/DecisionRecordedEvent"
                  },
                  "eventId": {
                    "description": "Unique per event. Repeated attempts carry the same id.",
                    "type": "string"
                  },
                  "name": {
                    "const": "decision.recorded",
                    "type": "string"
                  },
                  "timestamp": {
                    "description": "When the event happened.",
                    "format": "date-time",
                    "type": "string"
                  }
                },
                "required": [
                  "eventId",
                  "name",
                  "timestamp",
                  "data",
                  "cursor"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "410": {
            "description": "Gone: VoiceCap stops this subscription and sends it nothing more."
          },
          "2XX": {
            "description": "Received. Answer within 10 seconds; the body is ignored."
          }
        },
        "security": [],
        "summary": "Decision recorded",
        "tags": [
          "Webhooks"
        ]
      }
    },
    "meeting.completed": {
      "post": {
        "description": "A meeting finished processing: its summary, action items and decisions are ready. Sent once per meeting. Subscribe with event meeting.completed; its filters are MeetingCompletedFilters.",
        "operationId": "onMeetingCompleted",
        "parameters": [
          {
            "description": "The event id, the same as eventId in the body. Use it to drop duplicates.",
            "in": "header",
            "name": "webhook-id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "When this attempt was signed, in Unix seconds.",
            "in": "header",
            "name": "webhook-timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Standard Webhooks signature: space-separated v1,<base64> values. Verify it with the whsec_ secret from Subscribe a webhook.",
            "in": "header",
            "name": "webhook-signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "The subscription this delivery belongs to.",
            "in": "header",
            "name": "X-VoiceCap-Subscription-Id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "cursor": null,
                "data": {
                  "actionItems": [
                    {
                      "assignee": "Sam Lee",
                      "completed": false,
                      "id": "9b2e4d6f-1a3c-4b5d-8e7f-0a1b2c3d4e5f",
                      "text": "Send the contract draft to Acme"
                    }
                  ],
                  "classification": "external",
                  "completedAt": "2026-10-14T10:07:12.000Z",
                  "counts": {
                    "actionItems": 1,
                    "decisions": 1
                  },
                  "decisions": [
                    {
                      "decidedBy": "Alex Morgan",
                      "id": "6a1f3c2e-9d4b-4e8a-b7c5-1f2e3d4c5b6a",
                      "statement": "Start the pilot in November with two teams"
                    }
                  ],
                  "durationSeconds": 3480,
                  "groups": [
                    {
                      "id": "2b4d6f8a-0c1e-4a3b-9d5f-7e9a1c3b5d7f",
                      "name": "Sales"
                    }
                  ],
                  "id": "0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f",
                  "keyTopics": [
                    "Pilot scope",
                    "Pricing",
                    "Next steps"
                  ],
                  "language": "en",
                  "meetingId": "0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f",
                  "participants": [
                    {
                      "email": "alex@example.com",
                      "name": "Alex Morgan"
                    },
                    {
                      "email": "sam@example.org",
                      "name": "Sam Lee"
                    }
                  ],
                  "recordedAt": "2026-10-14T09:00:00.000Z",
                  "summary": "Acme agreed to start the pilot in November with two teams. Pricing stays as proposed for the first year. Sam will send the contract draft by Friday.",
                  "summaryExcerpt": "Acme agreed to start the pilot in November with two teams.",
                  "title": "Quarterly planning with Acme",
                  "url": "https://voicecap.ai/meetings/0f8c2a4e-7b1d-4c3e-9a5f-2d6b8e1c4a7f"
                },
                "eventId": "5c7d9e1f-2a3b-4c4d-9e5f-6a7b8c9d0e1f",
                "name": "meeting.completed",
                "timestamp": "2026-10-14T10:07:12.000Z"
              },
              "schema": {
                "additionalProperties": false,
                "properties": {
                  "cursor": {
                    "type": "null"
                  },
                  "data": {
                    "$ref": "#/components/schemas/MeetingCompletedEvent"
                  },
                  "eventId": {
                    "description": "Unique per event. Repeated attempts carry the same id.",
                    "type": "string"
                  },
                  "name": {
                    "const": "meeting.completed",
                    "type": "string"
                  },
                  "timestamp": {
                    "description": "When the event happened.",
                    "format": "date-time",
                    "type": "string"
                  }
                },
                "required": [
                  "eventId",
                  "name",
                  "timestamp",
                  "data",
                  "cursor"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "410": {
            "description": "Gone: VoiceCap stops this subscription and sends it nothing more."
          },
          "2XX": {
            "description": "Received. Answer within 10 seconds; the body is ignored."
          }
        },
        "security": [],
        "summary": "Meeting completed",
        "tags": [
          "Webhooks"
        ]
      }
    }
  }
}
