Meetgeek AI Api

https://docs.meetgeek.ai/api/
Admin
A minimal, unversioned project without explicit documentation or common project configuration files.
Tokens:13,875
Snippets:70
Trust Score:9.8
Update:4 months ago
Show doc for...
Tokens:
Raw
### Meeting Summary Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Example of a successful meeting summary response, including meeting ID, AI insights, and a detailed summary.

```json
{
  "meeting_id": "17c36737-1bf5-4626-8483-88285f6a33ee",
  "ai_insights": ">-
The meeting demonstrated a strong overall performance, particularly\n            in clarity of action items and time management efficiency, with\n            several instances of clear communication regarding responsibilities\n            and effective adherence to the schedule. Engagement levels were\n            notably high, reflecting active participation from team members,\n            although there were some areas where clarity in action items could\n            be improved.",
  "summary": ">-
John discussed the importance of monitoring the company’s quarterly\n            results by cross-checking KPIs from various data ingestors. He\n            emphasized the need for a comprehensive approach, integrating data\n            from sales, marketing, and customer feedback channels to get a\n            holistic view of performance. By comparing these metrics, John\n            believes the company can identify trends, spot discrepancies, and\n            make data-driven decisions. He also suggested implementing real-time\n            dashboards to ensure that key stakeholders can access up-to-date\n            information, enabling swift adjustments to strategy as needed."
}
```

--------------------------------

### Unauthorized Error Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Example of an unauthorized error response, typically due to invalid or missing authentication credentials.

```json
{
  "message": "unauthorized"
}
```

--------------------------------

### Page Model Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/transcript

Represents a paginated response structure, including cursors for navigation.

```json
{
  "next_cursor": "gASVSgAAAAAAAABdlCiMGDIwMj==",
  "previous_cursor": "sDAACgCCCBo97zDAsCqcADPUzA=="
}
```

--------------------------------

### Bad Request Error Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Example of a bad request error response, indicating a problem with the request parameters.

```json
{
  "message": "bad request",
  "reason": "missing api key"
}
```

--------------------------------

### Quota Limit Reached Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/transcript

Illustrates the structure of a response when a quota limit is reached.

```json
{
  "error": {
    "code": "quota_limit_reached",
    "message": "Quota limit reached",
    "unit": "day"
  }
}
```

--------------------------------

### Verify Webhook Signature in Go

Source: https://docs.meetgeek.ai/api/api-reference/v1/appendix-webhooks

Example of how to verify the X-MG-Signature header in Go using HMAC SHA-256. Use hmac.Equal for constant-time comparison.

```go
import (
    "crypto/hmac"
    "crypto/sha256"
    "encoding/hex"
)

func IsValid(secret []byte, body []byte, sigHeader string) bool {
    mac := hmac.New(sha256.New, secret)
    mac.Write(body)
    expected := hex.EncodeToString(mac.Sum(nil))
    return hmac.Equal([]byte(expected), []byte(sigHeader))
}
```

--------------------------------

### Internal Server Error Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/transcript

Defines the structure for an internal server error response.

```json
{
  "error": {
    "code": "internal_server_error",
    "message": "internal server error"
  }
}
```

--------------------------------

### GET /v1/meetings/{meetingId}/summary

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Retrieves a summary for a given meeting ID. Requires authentication.

```yaml
openapi: 3.0.0
info:
  description: This is a sample server celler server.
  title: MeetGeek API
  termsOfService: http://swagger.io/terms/
  contact:
    name: API Support
    url: http://www.swagger.io/support
    email: support@swagger.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://api.meetgeek.ai
  - url: https://api-eu.meetgeek.ai
  - url: https://api-us.meetgeek.ai
security:
  - Bearer: []
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /v1/meetings/{meetingId}/summary:
    get:
      tags:
        - transcript
      summary: Retrives a meeting summary
      description: Get summary given the meeting id
      parameters:
        - description: Meeting ID
          name: meetingId
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_models.Summary
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.BadRequestError
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.UnauthorizedError
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.AccessDeniedError
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.MeetingNotFoundError
        '410':
          description: Gone
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.GoneError
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.QuotaLimitReachedError
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.InternalServerError
      security:
        - Bearer: []
components:
  schemas:
    github_com_meetgeekai_api_internal_models.Summary:
      type: object
      properties:
        meeting_id:
          type: string
          example: 17c36737-1bf5-4626-8483-88285f6a33ee
        ai_insights:
          type: string
          example: >-
            The meeting demonstrated a strong overall performance, particularly
            in clarity of action items and time management efficiency, with
            several instances of clear communication regarding responsibilities
            and effective adherence to the schedule. Engagement levels were
            notably high, reflecting active participation from team members,
            although there were some areas where clarity in action items could
            be improved.
        summary:
          type: string
          example: >-
            John discussed the importance of monitoring the company’s quarterly
            results by cross-checking KPIs from various data ingestors. He
            emphasized the need for a comprehensive approach, integrating data
            from sales, marketing, and customer feedback channels to get a
            holistic view of performance. By comparing these metrics, John
            believes the company can identify trends, spot discrepancies, and
            make data-driven decisions. He also suggested implementing real-time
            dashboards to ensure that key stakeholders can access up-to-date
            information, enabling swift adjustments to strategy as needed.
    github_com_meetgeekai_api_internal_errors.BadRequestError:
      type: object
      properties:
        message:
          type: string
          example: bad request
        reason:
          type: string
          example: missing api key
    github_com_meetgeekai_api_internal_errors.UnauthorizedError:
      type: object
      properties:
        message:
          type: string
          example: unauthorized
    github_com_meetgeekai_api_internal_errors.AccessDeniedError:

```

--------------------------------

### Verify Webhook Signature in Node.js

Source: https://docs.meetgeek.ai/api/api-reference/v1/appendix-webhooks

Example of how to verify the X-MG-Signature header in Node.js using the crypto module. The body must be a raw buffer.

```javascript
const crypto = require('crypto');

// body must be raw buffer from req.body
function isValid(secret, body, sigHeader) {
    const expected = crypto
        .createHmac('sha256', secret)
        .update(body)
        .digest('hex');
    
    return crypto.timingSafeEqual(
        Buffer.from(expected),
        Buffer.from(sigHeader)
    );
}
```

--------------------------------

### Get Meeting Summary

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Fetches a summary of a meeting using its ID.

```APIDOC
## GET /websites/meetgeek_ai_api/summary

### Description
Get summary given the meeting id

### Method
GET

### Endpoint
/websites/meetgeek_ai_api/summary

### Parameters
#### Query Parameters
- **meeting_id** (string) - Required - The unique identifier of the meeting for which to retrieve the summary.
```

--------------------------------

### Verify Webhook Signature in Python

Source: https://docs.meetgeek.ai/api/api-reference/v1/appendix-webhooks

Example of how to verify the X-MG-Signature header in Python using HMAC SHA-256. Ensure you use a constant-time comparison function.

```python
import hmac
import hashlib

def is_valid(secret: str, body: bytes, sig_header: str) -> bool:
    expected = hmac.new(
        key=secret.encode(),
        msg=body,
        digestmod=hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"{expected}", sig_header)
```

--------------------------------

### Sentence Model Example

Source: https://docs.meetgeek.ai/api/api-reference/v1/transcript

Details the structure of a single sentence within a transcript, including speaker and timestamp.

```json
{
  "id": 1,
  "speaker": "John Doe",
  "timestamp": "2024-08-08T14:00:34Z",
  "transcript": "Previous quarter was great!"
}
```

--------------------------------

### Get meetings

Source: https://docs.meetgeek.ai/api/api-reference/v1/meetings

Retrieves paginated past meetings of a user.

```APIDOC
## GET /meetings

### Description
Retrieves paginated past meetings of a user.

### Method
GET

### Endpoint
/meetings

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve.
- **pageSize** (integer) - Optional - The number of meetings to return per page.

### Response
#### Success Response (200)
- **meetings** (array) - A list of past meetings.
  - **meetingId** (string) - The unique identifier for the meeting.
  - **startTime** (string) - The start time of the meeting (ISO 8601 format).
  - **endTime** (string) - The end time of the meeting (ISO 8601 format).
  - **title** (string) - The title of the meeting.
- **totalMeetings** (integer) - The total number of meetings available.
- **currentPage** (integer) - The current page number.
- **pageSize** (integer) - The number of meetings per page.
```

--------------------------------

### Get Meeting Details

Source: https://docs.meetgeek.ai/api/api-reference/v1/meeting

Fetches the details of a specific meeting using its unique identifier.

```APIDOC
## Get Meeting Details

### Description
Retrieves meeting details based on the provided meeting ID.

### Method
GET

### Endpoint
/api/v1/meetings/{meeting_id}

### Parameters
#### Path Parameters
- **meeting_id** (string) - Required - The unique identifier of the meeting.
```

--------------------------------

### Verify Webhook Signature in Java (Spring Boot)

Source: https://docs.meetgeek.ai/api/api-reference/v1/appendix-webhooks

Example of how to verify the X-MG-Signature header in Java using HMAC SHA256. It includes a helper method to convert bytes to hex.

```java
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.security.MessageDigest;

public static boolean isValidSignature(String secret, byte[] body, String headerSig) throws Exception {
    Mac hmac = Mac.getInstance("HmacSHA256");
    hmac.init(new SecretKeySpec(secret.getBytes("UTF-8"), "HmacSHA256"));
    byte[] hash = hmac.doFinal(body);
    String expected = bytesToHex(hash);
    return MessageDigest.isEqual(expected.getBytes("UTF-8"), headerSig.getBytes("UTF-8"));
}

private static String bytesToHex(byte[] bytes) {
    StringBuilder sb = new StringBuilder();
    for (byte b : bytes) sb.append(String.format("%02x", b));
    return sb.toString();
}
```

--------------------------------

### GET /v1/meetings

Source: https://docs.meetgeek.ai/api/api-reference/v1/meetings

Retrieves a paginated list of past meetings for a user. You can control the number of results and specify a cursor for continued pagination.

```APIDOC
## GET /v1/meetings

### Description
Retrieves paginated past meetings of a user.

### Method
GET

### Endpoint
/v1/meetings

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - Number of records to fetch. Minimum: 1, Maximum: 500.
- **cursor** (string) - Optional - Cursor to continue reading from.

### Responses
#### Success Response (200)
- **meetings** (array) - A list of meeting objects.
- **pagination** (object) - Pagination details.

#### Error Responses
- **400** - Bad Request
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
- **429** - Too Many Requests
- **500** - Internal Server Error
```

--------------------------------

### GET /v1/meetings/{meetingId}/transcript

Source: https://docs.meetgeek.ai/api/api-reference/v1/transcript

Retrieves a transcript for a given meeting ID. Supports pagination and filtering.

```APIDOC
## GET /v1/meetings/{meetingId}/transcript

### Description
Get all transcript sentences by meeting id. This endpoint retrieves a transcript for a given meeting ID and supports pagination.

### Method
GET

### Endpoint
/v1/meetings/{meetingId}/transcript

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - Meeting ID

#### Query Parameters
- **limit** (integer) - Optional - Number of records to fetch. Minimum: 1, Maximum: 500.
- **cursor** (string) - Optional - Cursor to continue reading from. Minimum length: 0.

### Response
#### Success Response (200)
- **meeting_id** (string) - The ID of the meeting.
- **pagination** (object) - Pagination details.
- **sentences** (array) - An array of transcript sentences.

#### Response Example
```json
{
  "meeting_id": "17c36737-1bf5-4626-8483-88285f6a33ee",
  "pagination": {},
  "sentences": []
}
```

#### Error Responses
- **400** - Bad Request: Indicates an issue with the request parameters.
- **401** - Unauthorized: Indicates missing or invalid authentication.
- **403** - Forbidden: Indicates the user does not have permission to access the resource.
- **404** - Not Found: Indicates the specified meeting was not found.
- **410** - Gone: Indicates the requested resource is no longer available.
- **429** - Too Many Requests: Indicates the rate limit has been exceeded.
- **500** - Internal Server Error: Indicates a server-side error.
```

--------------------------------

### GET /v1/meetings/{meetingId}/summary

Source: https://docs.meetgeek.ai/api/api-reference/v1/summary

Retrieves a summary for a given meeting ID. This endpoint provides AI-generated insights and a concise summary of the meeting content.

```APIDOC
## GET /v1/meetings/{meetingId}/summary

### Description
Retrieves a summary for a given meeting ID. This endpoint provides AI-generated insights and a concise summary of the meeting content.

### Method
GET

### Endpoint
/v1/meetings/{meetingId}/summary

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - The unique identifier of the meeting.

### Response
#### Success Response (200)
- **meeting_id** (string) - The ID of the meeting.
- **ai_insights** (string) - AI-generated insights from the meeting.
- **summary** (string) - A concise summary of the meeting.

#### Response Example
```json
{
  "meeting_id": "17c36737-1bf5-4626-8483-88285f6a33ee",
  "ai_insights": "The meeting demonstrated a strong overall performance, particularly in clarity of action items and time management efficiency, with several instances of clear communication regarding responsibilities and effective adherence to the schedule. Engagement levels were notably high, reflecting active participation from team members, although there were some areas where clarity in action items could be improved.",
  "summary": "John discussed the importance of monitoring the company’s quarterly results by cross-checking KPIs from various data ingestors. He emphasized the need for a comprehensive approach, integrating data from sales, marketing, and customer feedback channels to get a holistic view of performance. By comparing these metrics, John believes the company can identify trends, spot discrepancies, and make data-driven decisions. He also suggested implementing real-time dashboards to ensure that key stakeholders can access up-to-date information, enabling swift adjustments to strategy as needed."
}
```

#### Error Responses
- **400** Bad Request: Indicates an issue with the request format or parameters.
- **401** Unauthorized: Indicates that the request lacks valid authentication credentials.
- **403** Forbidden: Indicates that the authenticated user does not have permission to access the resource.
- **404** Not Found: Indicates that the specified meeting ID does not exist.
- **410** Gone: Indicates that the requested resource is no longer available.
- **429** Too Many Requests: Indicates that the rate limit has been exceeded.
- **500** Internal Server Error: Indicates an unexpected server error.
```

--------------------------------

### GET /v1/meetings/{meetingId}/highlights

Source: https://docs.meetgeek.ai/api/api-reference/v1/highlights

Retrieves highlights for a specific meeting using its ID. You can optionally filter highlights by type.

```APIDOC
## GET /v1/meetings/{meetingId}/highlights

### Description
Get all highlights by meeting id. You can optionally filter highlights by type.

### Method
GET

### Endpoint
/v1/meetings/{meetingId}/highlights

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - The ID of the meeting.

#### Query Parameters
- **type** (string) - Optional - Type of highlights to retrieve (e.g. 'next_steps').

### Responses
#### Success Response (200)
- **meeting_id** (string) - The ID of the meeting.
- **highlights** (array) - A list of highlight objects.

#### Error Responses
- **400** - Bad Request: Indicates an issue with the request format or parameters.
- **401** - Unauthorized: Authentication is required and has failed or not been provided.
- **403** - Forbidden: The authenticated user does not have permission to access the resource.
- **404** - Not Found: The specified meeting ID does not exist.
- **410** - Gone: The requested resource is no longer available.
- **429** - Too Many Requests: The rate limit has been exceeded.
- **500** - Internal Server Error: An unexpected error occurred on the server.
```

--------------------------------

### GET /v1/teams

Source: https://docs.meetgeek.ai/api/api-reference/v1/teams

Retrieves a list of teams associated with the authenticated user. This includes teams the user has share access to and teams they have view access to.

```APIDOC
## GET /v1/teams

### Description
Retrieves a list of teams associated with the authenticated user. This includes teams the user has share access to and teams they have view access to.

### Method
GET

### Endpoint
/v1/teams

### Parameters

### Request Body

### Request Example

### Response
#### Success Response (200)
- **share_access** (array) - A list of teams the user has share access to.
  - **id** (integer) - The unique identifier for the team.
  - **name** (string) - The name of the team.
- **view_access** (array) - A list of teams the user has view access to.
  - **id** (integer) - The unique identifier for the team.
  - **name** (string) - The name of the team.

#### Response Example
```json
{
  "share_access": [
    {
      "id": 101437,
      "name": "Marketing Team"
    },
    {
      "id": 101438,
      "name": "Sales Team"
    }
  ],
  "view_access": [
    {
      "id": 101437,
      "name": "Marketing Team"
    },
    {
      "id": 101439,
      "name": "Engineering Team"
    }
  ]
}
```

#### Error Response
- **400** Bad Request: Indicates a malformed request.
- **401** Unauthorized: Indicates missing or invalid authentication credentials.
- **403** Forbidden: Indicates the user does not have permission to access the resource.
- **429** Too Many Requests: Indicates the user has exceeded the rate limit.
- **500** Internal Server Error: Indicates an unexpected server error.
```

--------------------------------

### Retrieve Meeting by ID

Source: https://docs.meetgeek.ai/api/api-reference/v1/meeting

Fetches the details of a specific meeting using its unique identifier. This endpoint allows you to get comprehensive information about a past or scheduled meeting.

```APIDOC
## GET /v1/meetings/{meetingId}

### Description
Get meeting details given a meeting id

### Method
GET

### Endpoint
/v1/meetings/{meetingId}

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - Meeting ID

### Response
#### Success Response (200)
- **host_email** (string) - The email address of the meeting host.
- **language** (string) - The primary language of the meeting.
- **meeting_id** (string) - The unique identifier for the meeting.
- **participant_emails** (array of strings) - A list of email addresses of the meeting participants.
- **source** (string) - The source platform of the meeting (e.g., 'google').
- **join_link** (string) - The URL to join the meeting.
- **timestamp_end_utc** (string) - The UTC timestamp when the meeting ended.
- **timestamp_start_utc** (string) - The UTC timestamp when the meeting started.
- **timezone** (string) - The timezone of the meeting.
- **title** (string) - The title of the meeting.
- **template** (object) - Information about the meeting template.
  - **id** (integer) - The ID of the template.
  - **name** (string) - The name of the template.
- **team_ids** (array of numbers) - Team IDs for the teams that have access to this meeting.
- **event_id** (string) - Internal event identifier from the calendar provider.

#### Response Example
{
  "host_email": "sasha@example.com",
  "language": "en-US",
  "meeting_id": "7e0f1953-b2ce-45b8-97b2-03c09da3a602",
  "participant_emails": [
    "john@example.com",
    "maria@example.com"
  ],
  "source": "google",
  "join_link": "https://meet.google.com/jcn-vnax-tkf",
  "timestamp_end_utc": "2024-08-08T14:00:34Z",
  "timestamp_start_utc": "2024-08-08T13:00:38Z",
  "timezone": "Europe/Paris",
  "title": "All-hands Meeting",
  "template": {
    "id": 611549,
    "name": "General meeting"
  },
  "team_ids": [
    123,
    456
  ],
  "event_id": "0qbhrdosgr33g7s49nq9h3uml7_20250918T080000Z"
}
```

--------------------------------

### Get paginated meetings of a team

Source: https://docs.meetgeek.ai/api/api-reference/v1/team-meetings

Retrieves a paginated list of past meetings for a given team. You can control the number of results and use a cursor for continued pagination.

```APIDOC
## GET /v1/teams/{teamId}/meetings

### Description
Retrieves paginated past meetings of a user.

### Method
GET

### Endpoint
/v1/teams/{teamId}/meetings

### Parameters
#### Path Parameters
- **teamId** (integer) - Required - Team ID

#### Query Parameters
- **limit** (integer) - Optional - Number of records to fetch. Minimum: 1, Maximum: 500
- **cursor** (string) - Optional - Cursor to continue reading from

### Response
#### Success Response (200)
- **meetings** (array) - List of meetings.
- **pagination** (object) - Pagination information.

#### Response Example
{
  "meetings": [
    {
      "meeting_id": "7e0f1953-b2ce-45b8-97b2-03c09da3a602",
      "timestamp_end_utc": "2023-10-27T10:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "some_cursor_string"
  }
}

#### Error Responses
- **400** - Bad Request
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
- **429** - Too Many Requests
- **500** - Internal Server Error
```

--------------------------------

### OpenAPI Specification for Teams API

Source: https://docs.meetgeek.ai/api/api-reference/v1/teams

This OpenAPI 3.0 specification defines the GET /v1/teams endpoint for retrieving user teams. It includes details on request parameters, responses, and error schemas.

```yaml
openapi: 3.0.0
info:
  description: This is a sample server celler server.
  title: MeetGeek API
  termsOfService: http://swagger.io/terms/
  contact:
    name: API Support
    url: http://www.swagger.io/support
    email: support@swagger.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://api.meetgeek.ai
  - url: https://api-eu.meetgeek.ai
  - url: https://api-us.meetgeek.ai
security:
  - Bearer: []
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /v1/teams:
    get:
      tags:
        - bot
      summary: Get teams of user
      description: Get teams of user
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_models.GetTeamsResponse
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.BadRequestError
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.UnauthorizedError
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.AccessDeniedError
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.QuotaLimitReachedError
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.InternalServerError
      security:
        - Bearer: []
components:
  schemas:
    github_com_meetgeekai_api_internal_models.GetTeamsResponse:
      type: object
      properties:
        share_access:
          type: array
          items:
            $ref: >-
              #/components/schemas/github_com_meetgeekai_api_internal_models.Team
          example:
            - id: 101437
              name: Marketing Team
            - id: 101438
              name: Sales Team
        view_access:
          type: array
          items:
            $ref: >-
              #/components/schemas/github_com_meetgeekai_api_internal_models.Team
          example:
            - id: 101437
              name: Marketing Team
            - id: 101439
              name: Engineering Team
    github_com_meetgeekai_api_internal_errors.BadRequestError:
      type: object
      properties:
        message:
          type: string
          example: bad request
        reason:
          type: string
          example: missing api key
    github_com_meetgeekai_api_internal_errors.UnauthorizedError:
      type: object
      properties:
        message:
          type: string
          example: unauthorized
    github_com_meetgeekai_api_internal_errors.AccessDeniedError:
      type: object
      properties:
        message:
          type: string
          example: you do not have access to view this meeting
    github_com_meetgeekai_api_internal_errors.QuotaLimitReachedError:
      type: object
      properties:
        message:
          type: string
          example: quota limit reached
        unit:
          type: string
          example: day
    github_com_meetgeekai_api_internal_errors.InternalServerError:
      type: object
      properties:
        message:
          type: string
          example: internal server error
    github_com_meetgeekai_api_internal_models.Team:
      type: object
      properties:
        id:
          type: integer
          example: 101437
        name:
          type: string
          example: Marketing Team
  securitySchemes:
    Bearer:
      description: Type "Bearer" followed by a space and a token
      type: apiKey
      name: Authorization
      in: header

```

--------------------------------

### POST /v1/meetings/{meetingId}/download

Source: https://docs.meetgeek.ai/api/api-reference/v1/download

Generates a temporary link to download the recording for a specific meeting.

```APIDOC
## POST /v1/meetings/{meetingId}/download

### Description
Retrieves a temporary download link for a specific meeting recording.

### Method
POST

### Endpoint
/v1/meetings/{meetingId}/download

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - Meeting ID

### Response
#### Success Response (200)
- **download_link** (string) - A publicly accessible URL that includes a secure token. Accessing this link will immediately initiate the file download.
- **expires_in** (integer) - The number of seconds remaining until the download link expires and becomes invalid.

#### Response Example
```json
{
  "download_link": "https://media.meetgeek.ai/api/download?token=jQzYmM1NTAtM2NmMi00MmNhLW",
  "expires_in": 14400
}
```

#### Error Responses
- **400** Bad Request
- **401** Unauthorized
- **403** Forbidden
- **404** Not Found
- **410** Gone
- **429** Too Many Requests
- **500** Internal Server Error
```

--------------------------------

### Download Recording

Source: https://docs.meetgeek.ai/api/api-reference/v1/download

Retrieves a temporary download link for a specific meeting recording.

```APIDOC
## Download recording

### Description
Retrieves a temporary download link for a specific meeting recording.

### Method
GET

### Endpoint
`/download/{meetingId}`

### Parameters
#### Path Parameters
- **meetingId** (string) - Required - The ID of the meeting for which to download the recording.

### Response
#### Success Response (200)
- **downloadLink** (string) - A temporary URL to download the meeting recording.
- **expiresIn** (string) - The time in seconds until the download link expires.

#### Response Example
```json
{
  "downloadLink": "https://example.com/download/meeting_abc123.mp4?token=xyz789",
  "expiresIn": "14400"
}
```
```

--------------------------------

### Upload Recording

Source: https://docs.meetgeek.ai/api/api-reference/v1/upload

Upload a video or audio file for analysis and receive a notification upon completion. Ensure any provided download URL is publicly accessible and triggers an immediate download.

```APIDOC
## Upload Recording

### Description
Upload a video or audio file for analysis and receive a notification upon completion.

### Method
POST

### Endpoint
/v1/upload

### Parameters
#### Query Parameters
- **url** (string) - Optional - A publicly accessible URL to the video or audio file. If provided, the file will be downloaded and processed.

#### Request Body
- **file** (file) - Required - The video or audio file to upload for analysis.
- **webhook_url** (string) - Optional - A URL to receive a notification when the analysis is complete.

### Request Example
```json
{
  "file": "<binary data>",
  "webhook_url": "https://example.com/notification"
}
```

### Response
#### Success Response (200)
- **message** (string) - A confirmation message indicating the upload has started.
- **upload_id** (string) - The unique identifier for the upload process.

#### Response Example
```json
{
  "message": "Upload started successfully.",
  "upload_id": "upload_12345abcde"
}
```
```

--------------------------------

### POST /v1/upload

Source: https://docs.meetgeek.ai/api/api-reference/v1/upload

Uploads a video or audio file for analysis. The API accepts a publicly accessible URL for the file and returns a confirmation of submission. Analysis results are communicated via webhooks.

```APIDOC
## POST /v1/upload

### Description
Upload a video or audio file for analysis and receive a notification upon completion. The API confirms submission and sends final analysis status via webhooks.

### Method
POST

### Endpoint
/v1/upload

### Parameters
#### Request Body
- **download_url** (string) - Required - A publicly accessible URL that initiates a direct download when accessed.
- **language_code** (string) - Optional - The language code for the content. Consult the [appendix](/api-reference/v1/appendix-language-codes) for available options.
- **template_name** (string) - Optional - The name of the meeting template to use. Consult the [appendix](/api-reference/v1/appendix-template-names) for available options.

### Request Example
```json
{
  "download_url": "https://my-bucket.s3.us-west-2.amazonaws.com/photos/2023-08-23/meeting.mp4",
  "language_code": "en-US",
  "template_name": "General meeting"
}
```

### Response
#### Success Response (202)
- **message** (string) - Confirms the recording has been validated and submitted for analysis. Final status is sent via webhook.

#### Response Example
```json
{
  "message": "The recording has been validated and submitted for analysis"
}
```

#### Error Responses
- **400 Bad Request**: Indicates an issue with the request format or content.
- **401 Unauthorized**: Indicates missing or invalid authentication credentials.
- **403 Forbidden**: Indicates the user lacks the necessary permissions.
- **429 Too Many Requests**: Indicates the user has exceeded the rate limit.
- **500 Internal Server Error**: Indicates a server-side problem.
```

--------------------------------

### Bearer Token Authentication

Source: https://docs.meetgeek.ai/api/api-reference/v1/highlights

Explains how to authenticate API requests using a Bearer token.

```APIDOC
## Authentication

### Description
API requests must be authenticated using a Bearer token.

### Method
Header

### Parameter
- **Authorization** (apiKey) - Required - Type "Bearer" followed by a space and the authentication token.
```

--------------------------------

### Set Authorization Header

Source: https://docs.meetgeek.ai/api/getting-started/authorization

Include this header in your API requests to authenticate. Replace 'your_api_key' with your actual API key.

```javascript
Authorization: Bearer your_api_key
```

--------------------------------

### Highlight Object Structure

Source: https://docs.meetgeek.ai/api/api-reference/v1/highlights

Defines the structure of a Highlight object, including its text and associated label.

```APIDOC
## Highlight Object

### Description
Represents a highlight within the Meetgeek AI system, containing the highlighted text and a label.

### Properties
- **highlightText** (string) - The text content of the highlight. Example: "John has been assigned to cross check KPIs from different company data ingestors."
- **label** (string) - A label categorizing the highlight. Example: "Task"
```

--------------------------------

### OpenAPI Specification for Upload Endpoint

Source: https://docs.meetgeek.ai/api/api-reference/v1/upload

This OpenAPI 3.0 specification defines the POST /v1/upload endpoint. It includes details on the request body, which requires a download_url, and the possible response codes, including success (202) and various error scenarios (400, 401, 403, 429, 500).

```yaml
openapi: 3.0.0
info:
  description: This is a sample server celler server.
  title: MeetGeek API
  termsOfService: http://swagger.io/terms/
  contact:
    name: API Support
    url: http://www.swagger.io/support
    email: support@swagger.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  version: '1.0'
servers:
  - url: https://api.meetgeek.ai
  - url: https://api-eu.meetgeek.ai
  - url: https://api-us.meetgeek.ai
security:
  - Bearer: []
externalDocs:
  description: OpenAPI
  url: https://swagger.io/resources/open-api/
paths:
  /v1/upload:
    post:
      tags:
        - upload
      summary: Uploads a video or audio file
      description: >-
        Upload a video or audio file for analysis and receive a notification
        upon completion
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/github_com_meetgeekai_api_internal_models.UploadRequest
        description: Download information
        required: true
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_models.UploadResponse
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.BadRequestError
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.UnauthorizedError
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.AccessDeniedError
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.QuotaLimitReachedError
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/github_com_meetgeekai_api_internal_errors.InternalServerError
      security:
        - Bearer: []
components:
  schemas:
    github_com_meetgeekai_api_internal_models.UploadRequest:
      description: User account information with user id and username
      type: object
      required:
        - download_url
      properties:
        download_url:
          type: string
          description: >-
            A publicly accessible URL that initiates a direct download when
            accessed
          example: >-
            https://my-bucket.s3.us-west-2.amazonaws.com/photos/2023-08-23/meeting.mp4
        language_code:
          type: string
          description: >-
            Please consult the
            [appendix](/api-reference/v1/appendix-language-codes) for all
            available language code options
          example: en-US
        template_name:
          type: string
          description: >-
            Please consult the
            [appendix](/api-reference/v1/appendix-template-names) for all
            available meeting template options
          example: General meeting
    github_com_meetgeekai_api_internal_models.UploadResponse:
      type: object
      properties:
        message:
          type: string
          description: >-
            This response only confirms the submission status. The final
            analysis status will be sent later via a webhook. For more details,
            refer to the [appendix](/api-reference/v1/appendix-webhooks) for
            information on webhooks.
          example: The recording has been validated and submitted for analysis
    github_com_meetgeekai_api_internal_errors.BadRequestError:
      type: object
      properties:
        message:
          type: string
          example: bad request
        reason:
          type: string
          example: missing api key
    github_com_meetgeekai_api_internal_errors.UnauthorizedError:
      type: object
      properties:
        message:
          type: string
          example: unauthorized
    github_com_meetgeekai_api_internal_errors.AccessDeniedError:
      type: object
      properties:
        message:
          type: string
          example: you do not have access to view this meeting
    github_com_meetgeekai_api_internal_errors.QuotaLimitReachedError:
      type: object
      properties:
        message:
          type: string
          example: quota limit reached
        unit:

```
Tokens:
Raw