diff --git a/.markdownlintignore b/.markdownlintignore
new file mode 100644
index 00000000000..61d825ad239
--- /dev/null
+++ b/.markdownlintignore
@@ -0,0 +1,3 @@
+# Ignore auto-generated connector documentation files synced from airbyte-agent-connectors repo
+# These files are generated and have formatting that doesn't conform to markdownlint rules
+docs/ai-agents/connectors/**
diff --git a/docs/ai-agents/README.md b/docs/ai-agents/README.md
index 501de5df8eb..83c033d3af3 100644
--- a/docs/ai-agents/README.md
+++ b/docs/ai-agents/README.md
@@ -1,6 +1,16 @@
-import Taxonomy from "@site/static/_taxonomy_of_data_movement.md";
+---
+sidebar_position: 1
+---
-# Agent engine
+# AI agents
+
+Airbyte provides a set of tools to help you automate, understand, move, and work with your data in coordination with AI agents. Some of these tools are standalone open source solutions, and others are paid solutions built on top of Airbyte Cloud.
+
+- **Agent connectors**: Use Airbyte's AI-optimized, type-safe connectors to power your own AI agents, or use them with Airbyte's Connector MCP server. [View the GitHub repo](https://github.com/airbytehq/airbyte-agent-connectors) or [try the tutorial](quickstarts). You can set up your own agent and explore your data in 15 minutes or less.
+
+- **Airbyte Embedded**: Add hundreds of integrations into your product instantly. Your end-users can authenticate into their data sources and begin syncing data to your product. You no longer need to spend engineering cycles on data movement. Focus on what makes your product great, rather than maintaining data integrations.
+
+
diff --git a/docs/ai-agents/connectors/asana/CHANGELOG.md b/docs/ai-agents/connectors/asana/CHANGELOG.md
new file mode 100644
index 00000000000..40f6396bab1
--- /dev/null
+++ b/docs/ai-agents/connectors/asana/CHANGELOG.md
@@ -0,0 +1,146 @@
+# Changelog
+
+## [0.19.10] - 2025-12-13
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.19.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 4d366cb5
+- SDK version: 0.1.0
+
+## [0.19.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.19.7] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.19.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.19.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.19.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.19.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.19.2] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.19.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.19.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.18.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.17.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.16.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4c17f060
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 430a4e68
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: cd499acd
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b261c3a2
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/asana/README.md b/docs/ai-agents/connectors/asana/README.md
new file mode 100644
index 00000000000..526fde66a96
--- /dev/null
+++ b/docs/ai-agents/connectors/asana/README.md
@@ -0,0 +1,82 @@
+# Airbyte Asana AI Connector
+
+Asana is a work management platform that helps teams organize, track, and manage
+projects and tasks. This connector provides access to tasks, projects, workspaces,
+teams, and users for project tracking, workload analysis, and productivity insights.
+
+
+## Example Questions
+
+- What tasks are assigned to me this week?
+- List all projects in my workspace
+- Summarize my team's workload and task completion rates
+- Show me the tasks for the [ProjectName] project
+- Who are the team members in my [TeamName] team?
+- Find all tasks related to [ClientName] across my workspaces
+- Analyze the most active projects in my workspace last month
+- Compare task completion rates between my different teams
+- Identify overdue tasks across all my projects
+- Show me details of my current workspace and its users
+
+## Unsupported Questions
+
+- Create a new task for [TeamMember]
+- Update the priority of this task
+- Delete the project [ProjectName]
+- Schedule a new team meeting
+- Add a new team member to [Workspace]
+- Move this task to another project
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-asana
+```
+
+## Usage
+
+```python
+from airbyte_ai_asana import AsanaConnector, AsanaAuthConfig
+
+connector = AsanaConnector(
+ auth_config=AsanaAuthConfig(
+ access_token="...",
+ refresh_token="...",
+ client_id="...",
+ client_secret="..."
+ )
+)
+result = connector.tasks.list()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Tasks | [List](./REFERENCE.md#tasks-list), [Get](./REFERENCE.md#tasks-get) |
+| Project Tasks | [List](./REFERENCE.md#project-tasks-list) |
+| Workspace Task Search | [List](./REFERENCE.md#workspace-task-search-list) |
+| Projects | [List](./REFERENCE.md#projects-list), [Get](./REFERENCE.md#projects-get) |
+| Task Projects | [List](./REFERENCE.md#task-projects-list) |
+| Team Projects | [List](./REFERENCE.md#team-projects-list) |
+| Workspace Projects | [List](./REFERENCE.md#workspace-projects-list) |
+| Workspaces | [List](./REFERENCE.md#workspaces-list), [Get](./REFERENCE.md#workspaces-get) |
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Workspace Users | [List](./REFERENCE.md#workspace-users-list) |
+| Team Users | [List](./REFERENCE.md#team-users-list) |
+| Teams | [Get](./REFERENCE.md#teams-get) |
+| Workspace Teams | [List](./REFERENCE.md#workspace-teams-list) |
+| User Teams | [List](./REFERENCE.md#user-teams-list) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Asana API Reference](https://developers.asana.com/reference/rest-api-reference).
+
+## Version Information
+
+**Package Version:** 0.19.10
+
+**Connector Version:** 0.1.1
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb
\ No newline at end of file
diff --git a/docs/ai-agents/connectors/asana/REFERENCE.md b/docs/ai-agents/connectors/asana/REFERENCE.md
new file mode 100644
index 00000000000..1d6a235f408
--- /dev/null
+++ b/docs/ai-agents/connectors/asana/REFERENCE.md
@@ -0,0 +1,1129 @@
+# Asana
+
+## Supported Entities and Actions
+
+| Entity | Actions |
+|--------|---------|
+| Tasks | [List](#tasks-list), [Get](#tasks-get) |
+| Project Tasks | [List](#project-tasks-list) |
+| Workspace Task Search | [List](#workspace-task-search-list) |
+| Projects | [List](#projects-list), [Get](#projects-get) |
+| Task Projects | [List](#task-projects-list) |
+| Team Projects | [List](#team-projects-list) |
+| Workspace Projects | [List](#workspace-projects-list) |
+| Workspaces | [List](#workspaces-list), [Get](#workspaces-get) |
+| Users | [List](#users-list), [Get](#users-get) |
+| Workspace Users | [List](#workspace-users-list) |
+| Team Users | [List](#team-users-list) |
+| Teams | [Get](#teams-get) |
+| Workspace Teams | [List](#workspace-teams-list) |
+| User Teams | [List](#user-teams-list) |
+
+### Tasks
+
+#### Tasks List
+
+Returns a paginated list of tasks
+
+**Python SDK**
+
+```python
+asana.tasks.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "tasks",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `project` | `string` | No | The project to filter tasks on |
+| `workspace` | `string` | No | The workspace to filter tasks on |
+| `section` | `string` | No | The workspace to filter tasks on |
+| `assignee` | `string` | No | The assignee to filter tasks on |
+| `completed_since` | `string` | No | Only return tasks that have been completed since this time |
+| `modified_since` | `string` | No | Only return tasks that have been completed since this time |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+| `resource_subtype` | `string` | |
+| `created_by` | `object` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+#### Tasks Get
+
+Get a single task by its ID
+
+**Python SDK**
+
+```python
+asana.tasks.get(
+ task_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "tasks",
+ "action": "get",
+ "params": {
+ "task_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `task_gid` | `string` | Yes | Task GID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+
+
+
+
+### Project Tasks
+
+#### Project Tasks List
+
+Returns all tasks in a project
+
+**Python SDK**
+
+```python
+asana.project_tasks.list(
+ project_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "project_tasks",
+ "action": "list",
+ "params": {
+ "project_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `project_gid` | `string` | Yes | Project GID to list tasks from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `completed_since` | `string` | No | Only return tasks that have been completed since this time |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+| `resource_subtype` | `string` | |
+| `created_by` | `object` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Workspace Task Search
+
+#### Workspace Task Search List
+
+Returns tasks that match the specified search criteria. Note - This endpoint requires a premium Asana account.
+
+**Python SDK**
+
+```python
+asana.workspace_task_search.list(
+ workspace_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspace_task_search",
+ "action": "list",
+ "params": {
+ "workspace_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace_gid` | `string` | Yes | Workspace GID to search tasks in |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `text` | `string` | No | Search text to filter tasks |
+| `completed` | `boolean` | No | Filter by completion status |
+| `assignee.any` | `string` | No | Comma-separated list of assignee GIDs |
+| `projects.any` | `string` | No | Comma-separated list of project GIDs |
+| `sections.any` | `string` | No | Comma-separated list of section GIDs |
+| `teams.any` | `string` | No | Comma-separated list of team GIDs |
+| `followers.any` | `string` | No | Comma-separated list of follower GIDs |
+| `created_at.after` | `string` | No | Filter tasks created after this date (ISO 8601 format) |
+| `created_at.before` | `string` | No | Filter tasks created before this date (ISO 8601 format) |
+| `modified_at.after` | `string` | No | Filter tasks modified after this date (ISO 8601 format) |
+| `modified_at.before` | `string` | No | Filter tasks modified before this date (ISO 8601 format) |
+| `due_on.after` | `string` | No | Filter tasks due after this date (ISO 8601 date format) |
+| `due_on.before` | `string` | No | Filter tasks due before this date (ISO 8601 date format) |
+| `resource_subtype` | `string` | No | Filter by task resource subtype (e.g., default_task, milestone) |
+| `sort_by` | `string` | No | Field to sort by (e.g., created_at, modified_at, due_date) |
+| `sort_ascending` | `boolean` | No | Sort order (true for ascending, false for descending) |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+| `resource_subtype` | `string` | |
+| `created_by` | `object` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Projects
+
+#### Projects List
+
+Returns a paginated list of projects
+
+**Python SDK**
+
+```python
+asana.projects.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "projects",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `workspace` | `string` | No | The workspace to filter projects on |
+| `team` | `string` | No | The team to filter projects on |
+| `archived` | `boolean` | No | Filter by archived status |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+#### Projects Get
+
+Get a single project by its ID
+
+**Python SDK**
+
+```python
+asana.projects.get(
+ project_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "projects",
+ "action": "get",
+ "params": {
+ "project_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `project_gid` | `string` | Yes | Project GID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `archived` | `boolean` | |
+| `color` | `string \| null` | |
+| `completed` | `boolean` | |
+| `completed_at` | `string \| null` | |
+| `created_at` | `string` | |
+| `current_status` | `object \| null` | |
+| `current_status_update` | `object \| null` | |
+| `custom_fields` | `array` | |
+| `default_access_level` | `string` | |
+| `default_view` | `string` | |
+| `due_on` | `string \| null` | |
+| `due_date` | `string \| null` | |
+| `followers` | `array
+
+### Task Projects
+
+#### Task Projects List
+
+Returns all projects a task is in
+
+**Python SDK**
+
+```python
+asana.task_projects.list(
+ task_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "task_projects",
+ "action": "list",
+ "params": {
+ "task_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `task_gid` | `string` | Yes | Task GID to list projects from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Team Projects
+
+#### Team Projects List
+
+Returns all projects for a team
+
+**Python SDK**
+
+```python
+asana.team_projects.list(
+ team_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "team_projects",
+ "action": "list",
+ "params": {
+ "team_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `team_gid` | `string` | Yes | Team GID to list projects from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `archived` | `boolean` | No | Filter by archived status |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Workspace Projects
+
+#### Workspace Projects List
+
+Returns all projects in a workspace
+
+**Python SDK**
+
+```python
+asana.workspace_projects.list(
+ workspace_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspace_projects",
+ "action": "list",
+ "params": {
+ "workspace_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace_gid` | `string` | Yes | Workspace GID to list projects from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `archived` | `boolean` | No | Filter by archived status |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Workspaces
+
+#### Workspaces List
+
+Returns a paginated list of workspaces
+
+**Python SDK**
+
+```python
+asana.workspaces.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspaces",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+#### Workspaces Get
+
+Get a single workspace by its ID
+
+**Python SDK**
+
+```python
+asana.workspaces.get(
+ workspace_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspaces",
+ "action": "get",
+ "params": {
+ "workspace_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace_gid` | `string` | Yes | Workspace GID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+| `email_domains` | `array` | |
+| `is_organization` | `boolean` | |
+
+
+
+
+### Users
+
+#### Users List
+
+Returns a paginated list of users
+
+**Python SDK**
+
+```python
+asana.users.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+| `workspace` | `string` | No | The workspace to filter users on |
+| `team` | `string` | No | The team to filter users on |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+#### Users Get
+
+Get a single user by their ID
+
+**Python SDK**
+
+```python
+asana.users.get(
+ user_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "get",
+ "params": {
+ "user_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `user_gid` | `string` | Yes | User GID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `email` | `string` | |
+| `name` | `string` | |
+| `photo` | `object \| null` | |
+| `resource_type` | `string` | |
+| `workspaces` | `array` | |
+
+
+
+
+### Workspace Users
+
+#### Workspace Users List
+
+Returns all users in a workspace
+
+**Python SDK**
+
+```python
+asana.workspace_users.list(
+ workspace_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspace_users",
+ "action": "list",
+ "params": {
+ "workspace_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace_gid` | `string` | Yes | Workspace GID to list users from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Team Users
+
+#### Team Users List
+
+Returns all users in a team
+
+**Python SDK**
+
+```python
+asana.team_users.list(
+ team_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "team_users",
+ "action": "list",
+ "params": {
+ "team_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `team_gid` | `string` | Yes | Team GID to list users from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### Teams
+
+#### Teams Get
+
+Get a single team by its ID
+
+**Python SDK**
+
+```python
+asana.teams.get(
+ team_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "teams",
+ "action": "get",
+ "params": {
+ "team_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `team_gid` | `string` | Yes | Team GID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `name` | `string` | |
+| `organization` | `object` | |
+| `permalink_url` | `string` | |
+| `resource_type` | `string` | |
+
+
+
+
+### Workspace Teams
+
+#### Workspace Teams List
+
+Returns all teams in a workspace
+
+**Python SDK**
+
+```python
+asana.workspace_teams.list(
+ workspace_gid=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspace_teams",
+ "action": "list",
+ "params": {
+ "workspace_gid": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace_gid` | `string` | Yes | Workspace GID to list teams from |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+### User Teams
+
+#### User Teams List
+
+Returns all teams a user is a member of
+
+**Python SDK**
+
+```python
+asana.user_teams.list(
+ user_gid="",
+ organization=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "user_teams",
+ "action": "list",
+ "params": {
+ "user_gid": "",
+ "organization": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `user_gid` | `string` | Yes | User GID to list teams from |
+| `organization` | `string` | Yes | The workspace or organization to filter teams on |
+| `limit` | `integer` | No | Number of items to return per page |
+| `offset` | `string` | No | Pagination offset token |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `gid` | `string` | |
+| `resource_type` | `string` | |
+| `name` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_page` | `object \| null` | |
+
+
+
+
+
+## Authentication
+
+The Asana connector supports the following authentication methods:
+
+
+### Asana OAuth 2.0
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | Yes | OAuth access token for API requests |
+| `refresh_token` | `str` | Yes | OAuth refresh token for automatic token renewal |
+| `client_id` | `str` | Yes | Connected App Consumer Key |
+| `client_secret` | `str` | Yes | Connected App Consumer Secret |
+
+#### Example
+
+**Python SDK**
+
+```python
+AsanaConnector(
+ auth_config=AsanaAuthConfig(
+ access_token="",
+ refresh_token="",
+ client_id="",
+ client_secret=""
+ )
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "connector_definition_id": "d0243522-dccf-4978-8ba0-37ed47a0bdbf",
+ "auth_config": {
+ "access_token": "",
+ "refresh_token": "",
+ "client_id": "",
+ "client_secret": ""
+ },
+ "name": "My Asana Connector"
+}'
+```
+
diff --git a/docs/ai-agents/connectors/github/CHANGELOG.md b/docs/ai-agents/connectors/github/CHANGELOG.md
new file mode 100644
index 00000000000..70ad5b7f7d7
--- /dev/null
+++ b/docs/ai-agents/connectors/github/CHANGELOG.md
@@ -0,0 +1,141 @@
+# Changelog
+
+## [0.18.10] - 2025-12-13
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.18.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 4d366cb5
+- SDK version: 0.1.0
+
+## [0.18.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.18.7] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.18.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.18.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.18.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.18.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.18.2] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.18.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.18.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.17.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.16.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4c17f060
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 430a4e68
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b261c3a2
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/github/README.md b/docs/ai-agents/connectors/github/README.md
new file mode 100644
index 00000000000..5b08ec6d2a8
--- /dev/null
+++ b/docs/ai-agents/connectors/github/README.md
@@ -0,0 +1,87 @@
+# Airbyte Github AI Connector
+
+GitHub is a platform for version control and collaborative software development
+using Git. This connector provides access to repositories, branches, commits, issues,
+pull requests, reviews, comments, releases, organizations, teams, and users for
+development workflow analysis and project management insights.
+
+
+## Example Questions
+
+- Show me all open issues in my repositories this month
+- List the top 5 repositories I've starred recently
+- Analyze the commit trends in my main project over the last quarter
+- Find all pull requests created by [teamMember] in the past two weeks
+- Search for repositories related to machine learning in my organizations
+- Compare the number of contributors across my different team projects
+- Identify the most active branches in my main repository
+- Get details about the most recent releases in my organization
+- List all milestones for our current development sprint
+- Show me insights about pull request review patterns in our team
+
+## Unsupported Questions
+
+- Create a new issue in the project repository
+- Update the status of this pull request
+- Delete an old branch from the repository
+- Schedule a team review for this code
+- Assign a new label to this issue
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-github
+```
+
+## Usage
+
+```python
+from airbyte_ai_github import GithubConnector, GithubAuthConfig
+
+connector = GithubConnector(
+ auth_config=GithubAuthConfig(
+ access_token="...",
+ refresh_token="...",
+ client_id="...",
+ client_secret="..."
+ )
+)
+result = connector.repositories.get()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Repositories | [Get](./REFERENCE.md#repositories-get), [List](./REFERENCE.md#repositories-list), [Search](./REFERENCE.md#repositories-search) |
+| Org Repositories | [List](./REFERENCE.md#org-repositories-list) |
+| Branches | [List](./REFERENCE.md#branches-list), [Get](./REFERENCE.md#branches-get) |
+| Commits | [List](./REFERENCE.md#commits-list), [Get](./REFERENCE.md#commits-get) |
+| Releases | [List](./REFERENCE.md#releases-list), [Get](./REFERENCE.md#releases-get) |
+| Issues | [List](./REFERENCE.md#issues-list), [Get](./REFERENCE.md#issues-get), [Search](./REFERENCE.md#issues-search) |
+| Pull Requests | [List](./REFERENCE.md#pull-requests-list), [Get](./REFERENCE.md#pull-requests-get), [Search](./REFERENCE.md#pull-requests-search) |
+| Reviews | [List](./REFERENCE.md#reviews-list) |
+| Comments | [List](./REFERENCE.md#comments-list), [Get](./REFERENCE.md#comments-get) |
+| Pr Comments | [List](./REFERENCE.md#pr-comments-list), [Get](./REFERENCE.md#pr-comments-get) |
+| Labels | [List](./REFERENCE.md#labels-list), [Get](./REFERENCE.md#labels-get) |
+| Milestones | [List](./REFERENCE.md#milestones-list), [Get](./REFERENCE.md#milestones-get) |
+| Organizations | [Get](./REFERENCE.md#organizations-get), [List](./REFERENCE.md#organizations-list) |
+| Users | [Get](./REFERENCE.md#users-get), [List](./REFERENCE.md#users-list), [Search](./REFERENCE.md#users-search) |
+| Teams | [List](./REFERENCE.md#teams-list), [Get](./REFERENCE.md#teams-get) |
+| Tags | [List](./REFERENCE.md#tags-list), [Get](./REFERENCE.md#tags-get) |
+| Stargazers | [List](./REFERENCE.md#stargazers-list) |
+| Viewer | [Get](./REFERENCE.md#viewer-get) |
+| Viewer Repositories | [List](./REFERENCE.md#viewer-repositories-list) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Github API Reference](https://docs.github.com/en/rest).
+
+## Version Information
+
+**Package Version:** 0.18.10
+
+**Connector Version:** 0.1.1
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb
\ No newline at end of file
diff --git a/docs/ai-agents/connectors/github/REFERENCE.md b/docs/ai-agents/connectors/github/REFERENCE.md
new file mode 100644
index 00000000000..75746ef200a
--- /dev/null
+++ b/docs/ai-agents/connectors/github/REFERENCE.md
@@ -0,0 +1,1616 @@
+# Github
+
+## Supported Entities and Actions
+
+| Entity | Actions |
+|--------|---------|
+| Repositories | [Get](#repositories-get), [List](#repositories-list), [Search](#repositories-search) |
+| Org Repositories | [List](#org-repositories-list) |
+| Branches | [List](#branches-list), [Get](#branches-get) |
+| Commits | [List](#commits-list), [Get](#commits-get) |
+| Releases | [List](#releases-list), [Get](#releases-get) |
+| Issues | [List](#issues-list), [Get](#issues-get), [Search](#issues-search) |
+| Pull Requests | [List](#pull-requests-list), [Get](#pull-requests-get), [Search](#pull-requests-search) |
+| Reviews | [List](#reviews-list) |
+| Comments | [List](#comments-list), [Get](#comments-get) |
+| Pr Comments | [List](#pr-comments-list), [Get](#pr-comments-get) |
+| Labels | [List](#labels-list), [Get](#labels-get) |
+| Milestones | [List](#milestones-list), [Get](#milestones-get) |
+| Organizations | [Get](#organizations-get), [List](#organizations-list) |
+| Users | [Get](#users-get), [List](#users-list), [Search](#users-search) |
+| Teams | [List](#teams-list), [Get](#teams-get) |
+| Tags | [List](#tags-list), [Get](#tags-get) |
+| Stargazers | [List](#stargazers-list) |
+| Viewer | [Get](#viewer-get) |
+| Viewer Repositories | [List](#viewer-repositories-list) |
+
+### Repositories
+
+#### Repositories Get
+
+Gets information about a specific GitHub repository using GraphQL
+
+**Python SDK**
+
+```python
+github.repositories.get(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "repositories",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository (username or organization) |
+| `repo` | `string` | Yes | The name of the repository |
+| `fields` | `array` | No | Optional array of field names to select.
+If not provided, uses default fields.
+ |
+
+
+#### Repositories List
+
+Returns a list of repositories for the specified user using GraphQL
+
+**Python SDK**
+
+```python
+github.repositories.list(
+ username=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "repositories",
+ "action": "list",
+ "params": {
+ "username": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `username` | `string` | Yes | The username of the user whose repositories to list |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination (from previous response's endCursor) |
+| `fields` | `array` | No | Optional array of field names to select.
+If not provided, uses default fields.
+ |
+
+
+#### Repositories Search
+
+Search for GitHub repositories using GitHub's powerful search syntax.
+Examples: "language:python stars:>1000", "topic:machine-learning", "org:facebook is:public"
+
+
+**Python SDK**
+
+```python
+github.repositories.search(
+ query=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "repositories",
+ "action": "search",
+ "params": {
+ "query": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `string` | Yes | GitHub repository search query. Examples:
+- "language:python stars:>1000"
+- "topic:machine-learning"
+- "org:facebook is:public"
+ |
+| `limit` | `integer` | No | Number of results to return |
+| `after` | `string` | No | Cursor for pagination (from previous response's endCursor) |
+| `fields` | `array` | No | Optional array of field names to select.
+If not provided, uses default fields.
+ |
+
+
+### Org Repositories
+
+#### Org Repositories List
+
+Returns a list of repositories for the specified organization using GraphQL
+
+**Python SDK**
+
+```python
+github.org_repositories.list(
+ org=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "org_repositories",
+ "action": "list",
+ "params": {
+ "org": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `org` | `string` | Yes | The organization login/username |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Branches
+
+#### Branches List
+
+Returns a list of branches for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.branches.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "branches",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Branches Get
+
+Gets information about a specific branch using GraphQL
+
+**Python SDK**
+
+```python
+github.branches.get(
+ owner="",
+ repo="",
+ branch=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "branches",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "branch": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `branch` | `string` | Yes | The branch name |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Commits
+
+#### Commits List
+
+Returns a list of commits for the default branch using GraphQL
+
+**Python SDK**
+
+```python
+github.commits.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "commits",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Commits Get
+
+Gets information about a specific commit by SHA using GraphQL
+
+**Python SDK**
+
+```python
+github.commits.get(
+ owner="",
+ repo="",
+ sha=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "commits",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "sha": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `sha` | `string` | Yes | The commit SHA |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Releases
+
+#### Releases List
+
+Returns a list of releases for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.releases.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "releases",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Releases Get
+
+Gets information about a specific release by tag name using GraphQL
+
+**Python SDK**
+
+```python
+github.releases.get(
+ owner="",
+ repo="",
+ tag=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "releases",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "tag": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `tag` | `string` | Yes | The release tag name |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Issues
+
+#### Issues List
+
+Returns a list of issues for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.issues.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "issues",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `states` | `array<"OPEN" \| "CLOSED">` | No | Filter by issue state |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Issues Get
+
+Gets information about a specific issue using GraphQL
+
+**Python SDK**
+
+```python
+github.issues.get(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "issues",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The issue number |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Issues Search
+
+Search for issues using GitHub's search syntax
+
+**Python SDK**
+
+```python
+github.issues.search(
+ query=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "issues",
+ "action": "search",
+ "params": {
+ "query": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `string` | Yes | GitHub issue search query. Examples:
+- "repo:owner/name is:issue is:open"
+- "repo:owner/name is:issue label:bug"
+ |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Pull Requests
+
+#### Pull Requests List
+
+Returns a list of pull requests for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.pull_requests.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "pull_requests",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `states` | `array<"OPEN" \| "CLOSED" \| "MERGED">` | No | Filter by pull request state |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Pull Requests Get
+
+Gets information about a specific pull request using GraphQL
+
+**Python SDK**
+
+```python
+github.pull_requests.get(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "pull_requests",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The pull request number |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Pull Requests Search
+
+Search for pull requests using GitHub's search syntax
+
+**Python SDK**
+
+```python
+github.pull_requests.search(
+ query=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "pull_requests",
+ "action": "search",
+ "params": {
+ "query": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `string` | Yes | GitHub PR search query. Examples:
+- "repo:owner/name type:pr is:open"
+- "repo:owner/name type:pr author:username"
+ |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Reviews
+
+#### Reviews List
+
+Returns a list of reviews for the specified pull request using GraphQL
+
+**Python SDK**
+
+```python
+github.reviews.list(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "reviews",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The pull request number |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Comments
+
+#### Comments List
+
+Returns a list of comments for the specified issue using GraphQL
+
+**Python SDK**
+
+```python
+github.comments.list(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "comments",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The issue number |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Comments Get
+
+Gets information about a specific issue comment by its GraphQL node ID.
+
+Note: This endpoint requires a GraphQL node ID (e.g., 'IC_kwDOBZtLds6YWTMj'),
+not a numeric database ID. You can obtain node IDs from the Comments_List response,
+where each comment includes both 'id' (node ID) and 'databaseId' (numeric ID).
+
+
+**Python SDK**
+
+```python
+github.comments.get(
+ id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "comments",
+ "action": "get",
+ "params": {
+ "id": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `string` | Yes | The GraphQL node ID of the comment |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Pr Comments
+
+#### Pr Comments List
+
+Returns a list of comments for the specified pull request using GraphQL
+
+**Python SDK**
+
+```python
+github.pr_comments.list(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "pr_comments",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The pull request number |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Pr Comments Get
+
+Gets information about a specific pull request comment by its GraphQL node ID.
+
+Note: This endpoint requires a GraphQL node ID (e.g., 'IC_kwDOBZtLds6YWTMj'),
+not a numeric database ID. You can obtain node IDs from the PRComments_List response,
+where each comment includes both 'id' (node ID) and 'databaseId' (numeric ID).
+
+
+**Python SDK**
+
+```python
+github.pr_comments.get(
+ id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "pr_comments",
+ "action": "get",
+ "params": {
+ "id": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `string` | Yes | The GraphQL node ID of the comment |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Labels
+
+#### Labels List
+
+Returns a list of labels for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.labels.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "labels",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Labels Get
+
+Gets information about a specific label by name using GraphQL
+
+**Python SDK**
+
+```python
+github.labels.get(
+ owner="",
+ repo="",
+ name=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "labels",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "name": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `name` | `string` | Yes | The label name |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Milestones
+
+#### Milestones List
+
+Returns a list of milestones for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.milestones.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "milestones",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `states` | `array<"OPEN" \| "CLOSED">` | No | Filter by milestone state |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Milestones Get
+
+Gets information about a specific milestone by number using GraphQL
+
+**Python SDK**
+
+```python
+github.milestones.get(
+ owner="",
+ repo="",
+ number=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "milestones",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "number": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `number` | `integer` | Yes | The milestone number |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Organizations
+
+#### Organizations Get
+
+Gets information about a specific organization using GraphQL
+
+**Python SDK**
+
+```python
+github.organizations.get(
+ org=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "organizations",
+ "action": "get",
+ "params": {
+ "org": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `org` | `string` | Yes | The organization login/username |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Organizations List
+
+Returns a list of organizations the user belongs to using GraphQL
+
+**Python SDK**
+
+```python
+github.organizations.list(
+ username=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "organizations",
+ "action": "list",
+ "params": {
+ "username": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `username` | `string` | Yes | The username of the user |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Users
+
+#### Users Get
+
+Gets information about a specific user using GraphQL
+
+**Python SDK**
+
+```python
+github.users.get(
+ username=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "get",
+ "params": {
+ "username": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `username` | `string` | Yes | The username of the user |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Users List
+
+Returns a list of members for the specified organization using GraphQL
+
+**Python SDK**
+
+```python
+github.users.list(
+ org=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "list",
+ "params": {
+ "org": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `org` | `string` | Yes | The organization login/username |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Users Search
+
+Search for GitHub users using search syntax
+
+**Python SDK**
+
+```python
+github.users.search(
+ query=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "search",
+ "params": {
+ "query": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `query` | `string` | Yes | GitHub user search query. Examples:
+- "location:san francisco"
+- "followers:>1000"
+ |
+| `limit` | `integer` | No | Number of results to return |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Teams
+
+#### Teams List
+
+Returns a list of teams for the specified organization using GraphQL
+
+**Python SDK**
+
+```python
+github.teams.list(
+ org=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "teams",
+ "action": "list",
+ "params": {
+ "org": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `org` | `string` | Yes | The organization login/username |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Teams Get
+
+Gets information about a specific team using GraphQL
+
+**Python SDK**
+
+```python
+github.teams.get(
+ org="",
+ team_slug=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "teams",
+ "action": "get",
+ "params": {
+ "org": "",
+ "team_slug": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `org` | `string` | Yes | The organization login/username |
+| `team_slug` | `string` | Yes | The team slug |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Tags
+
+#### Tags List
+
+Returns a list of tags for the specified repository using GraphQL
+
+**Python SDK**
+
+```python
+github.tags.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "tags",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+#### Tags Get
+
+Gets information about a specific tag by name using GraphQL
+
+**Python SDK**
+
+```python
+github.tags.get(
+ owner="",
+ repo="",
+ tag=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "tags",
+ "action": "get",
+ "params": {
+ "owner": "",
+ "repo": "",
+ "tag": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `tag` | `string` | Yes | The tag name |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Stargazers
+
+#### Stargazers List
+
+Returns a list of users who have starred the repository using GraphQL
+
+**Python SDK**
+
+```python
+github.stargazers.list(
+ owner="",
+ repo=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "stargazers",
+ "action": "list",
+ "params": {
+ "owner": "",
+ "repo": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `owner` | `string` | Yes | The account owner of the repository |
+| `repo` | `string` | Yes | The name of the repository |
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Viewer
+
+#### Viewer Get
+
+Gets information about the currently authenticated user.
+This is useful when you don't know the username but need to access
+the current user's profile, permissions, or associated resources.
+
+
+**Python SDK**
+
+```python
+github.viewer.get()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "viewer",
+ "action": "get"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+### Viewer Repositories
+
+#### Viewer Repositories List
+
+Returns a list of repositories owned by the authenticated user.
+Unlike Repositories_List which requires a username, this endpoint
+automatically lists repositories for the current authenticated user.
+
+
+**Python SDK**
+
+```python
+github.viewer_repositories.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "viewer_repositories",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | The number of results per page |
+| `after` | `string` | No | Cursor for pagination (from previous response's endCursor) |
+| `fields` | `array` | No | Optional array of field names to select |
+
+
+
+
+## Authentication
+
+The Github connector supports the following authentication methods:
+
+
+### Authentication
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_token` | `str` | No | OAuth2 access token |
+| `refresh_token` | `str` | No | OAuth2 refresh token (optional) |
+| `client_id` | `str` | No | OAuth2 client ID (optional) |
+| `client_secret` | `str` | No | OAuth2 client secret (optional) |
+
+#### Example
+
+**Python SDK**
+
+```python
+GithubConnector(
+ auth_config=GithubAuthConfig(
+ access_token="",
+ refresh_token="",
+ client_id="",
+ client_secret=""
+ )
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "connector_definition_id": "ef69ef6e-aa7f-4af1-a01d-ef775033524e",
+ "auth_config": {
+ "access_token": "",
+ "refresh_token": "",
+ "client_id": "",
+ "client_secret": ""
+ },
+ "name": "My Github Connector"
+}'
+```
+
diff --git a/docs/ai-agents/connectors/gong/CHANGELOG.md b/docs/ai-agents/connectors/gong/CHANGELOG.md
new file mode 100644
index 00000000000..1e5f796a46b
--- /dev/null
+++ b/docs/ai-agents/connectors/gong/CHANGELOG.md
@@ -0,0 +1,156 @@
+# Changelog
+
+## [0.19.12] - 2025-12-13
+- Updated connector definition (YAML version 0.1.3)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.19.11] - 2025-12-12
+- Updated connector definition (YAML version 0.1.3)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.19.10] - 2025-12-12
+- Updated connector definition (YAML version 0.1.3)
+- Source commit: 87a2243c
+- SDK version: 0.1.0
+
+## [0.19.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.19.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 751920d7
+- SDK version: 0.1.0
+
+## [0.19.7] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 38493f4d
+- SDK version: 0.1.0
+
+## [0.19.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.19.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.19.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.19.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.19.2] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.19.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.19.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.18.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.17.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.16.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4c17f060
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 430a4e68
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: cd499acd
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b261c3a2
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/gong/README.md b/docs/ai-agents/connectors/gong/README.md
new file mode 100644
index 00000000000..5aea4effc81
--- /dev/null
+++ b/docs/ai-agents/connectors/gong/README.md
@@ -0,0 +1,81 @@
+# Airbyte Gong AI Connector
+
+Gong is a revenue intelligence platform that captures and analyzes customer interactions
+across calls, emails, and web conferences. This connector provides access to users,
+recorded calls with transcripts, activity statistics, scorecards, trackers, workspaces,
+coaching metrics, and library content for sales performance analysis and revenue insights.
+
+
+## Example Questions
+
+- List all users in my Gong account
+- Show me calls from last week
+- Get the transcript for call abc123
+- What are the activity stats for our sales team?
+- List all workspaces in Gong
+- Show me the scorecard configurations
+- What trackers are set up in my account?
+- Get coaching metrics for manager user123
+
+## Unsupported Questions
+
+- Create a new user in Gong
+- Delete a call recording
+- Update scorecard questions
+- Schedule a new meeting
+- Send feedback to a team member
+- Modify tracker keywords
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-gong
+```
+
+## Usage
+
+```python
+from airbyte_ai_gong import GongConnector, GongAuthConfig
+
+connector = GongConnector(
+ auth_config=GongAuthConfig(
+ access_key="...",
+ access_key_secret="..."
+ )
+)
+result = connector.users.list()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Calls | [List](./REFERENCE.md#calls-list), [Get](./REFERENCE.md#calls-get) |
+| Calls Extensive | [List](./REFERENCE.md#calls-extensive-list) |
+| Call Audio | [Download](./REFERENCE.md#call-audio-download) |
+| Call Video | [Download](./REFERENCE.md#call-video-download) |
+| Workspaces | [List](./REFERENCE.md#workspaces-list) |
+| Call Transcripts | [List](./REFERENCE.md#call-transcripts-list) |
+| Stats Activity Aggregate | [List](./REFERENCE.md#stats-activity-aggregate-list) |
+| Stats Activity Day By Day | [List](./REFERENCE.md#stats-activity-day-by-day-list) |
+| Stats Interaction | [List](./REFERENCE.md#stats-interaction-list) |
+| Settings Scorecards | [List](./REFERENCE.md#settings-scorecards-list) |
+| Settings Trackers | [List](./REFERENCE.md#settings-trackers-list) |
+| Library Folders | [List](./REFERENCE.md#library-folders-list) |
+| Library Folder Content | [List](./REFERENCE.md#library-folder-content-list) |
+| Coaching | [List](./REFERENCE.md#coaching-list) |
+| Stats Activity Scorecards | [List](./REFERENCE.md#stats-activity-scorecards-list) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Gong API Reference](https://gong.app.gong.io/settings/api/documentation).
+
+## Version Information
+
+**Package Version:** 0.19.12
+
+**Connector Version:** 0.1.3
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb
\ No newline at end of file
diff --git a/docs/ai-agents/connectors/gong/REFERENCE.md b/docs/ai-agents/connectors/gong/REFERENCE.md
new file mode 100644
index 00000000000..f3948ab6605
--- /dev/null
+++ b/docs/ai-agents/connectors/gong/REFERENCE.md
@@ -0,0 +1,1217 @@
+# Gong
+
+## Supported Entities and Actions
+
+| Entity | Actions |
+|--------|---------|
+| Users | [List](#users-list), [Get](#users-get) |
+| Calls | [List](#calls-list), [Get](#calls-get) |
+| Calls Extensive | [List](#calls-extensive-list) |
+| Call Audio | [Download](#call-audio-download) |
+| Call Video | [Download](#call-video-download) |
+| Workspaces | [List](#workspaces-list) |
+| Call Transcripts | [List](#call-transcripts-list) |
+| Stats Activity Aggregate | [List](#stats-activity-aggregate-list) |
+| Stats Activity Day By Day | [List](#stats-activity-day-by-day-list) |
+| Stats Interaction | [List](#stats-interaction-list) |
+| Settings Scorecards | [List](#settings-scorecards-list) |
+| Settings Trackers | [List](#settings-trackers-list) |
+| Library Folders | [List](#library-folders-list) |
+| Library Folder Content | [List](#library-folder-content-list) |
+| Coaching | [List](#coaching-list) |
+| Stats Activity Scorecards | [List](#stats-activity-scorecards-list) |
+
+### Users
+
+#### Users List
+
+Returns a list of all users in the Gong account
+
+**Python SDK**
+
+```python
+gong.users.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `emailAddress` | `string` | |
+| `created` | `string` | |
+| `active` | `boolean` | |
+| `emailAliases` | `array` | |
+| `trustedEmailAddress` | `string \| null` | |
+| `firstName` | `string` | |
+| `lastName` | `string` | |
+| `title` | `string \| null` | |
+| `phoneNumber` | `string \| null` | |
+| `extension` | `string \| null` | |
+| `personalMeetingUrls` | `array` | |
+| `settings` | `object` | |
+| `managerId` | `string \| null` | |
+| `meetingConsentPageUrl` | `string \| null` | |
+| `spokenLanguages` | `array` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+#### Users Get
+
+Get a single user by ID
+
+**Python SDK**
+
+```python
+gong.users.get(
+ id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "get",
+ "params": {
+ "id": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `string` | Yes | User ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `emailAddress` | `string` | |
+| `created` | `string` | |
+| `active` | `boolean` | |
+| `emailAliases` | `array` | |
+| `trustedEmailAddress` | `string \| null` | |
+| `firstName` | `string` | |
+| `lastName` | `string` | |
+| `title` | `string \| null` | |
+| `phoneNumber` | `string \| null` | |
+| `extension` | `string \| null` | |
+| `personalMeetingUrls` | `array` | |
+| `settings` | `object` | |
+| `managerId` | `string \| null` | |
+| `meetingConsentPageUrl` | `string \| null` | |
+| `spokenLanguages` | `array` | |
+
+
+
+
+### Calls
+
+#### Calls List
+
+Retrieve calls data by date range
+
+**Python SDK**
+
+```python
+gong.calls.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "calls",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `fromDateTime` | `string` | No | Start date in ISO 8601 format |
+| `toDateTime` | `string` | No | End date in ISO 8601 format |
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `url` | `string` | |
+| `title` | `string` | |
+| `scheduled` | `string` | |
+| `started` | `string` | |
+| `duration` | `integer` | |
+| `primaryUserId` | `string` | |
+| `direction` | `string` | |
+| `system` | `string` | |
+| `scope` | `string` | |
+| `media` | `string` | |
+| `language` | `string` | |
+| `workspaceId` | `string` | |
+| `sdrDisposition` | `string \| null` | |
+| `clientUniqueId` | `string \| null` | |
+| `customData` | `string \| null` | |
+| `purpose` | `string \| null` | |
+| `meetingUrl` | `string` | |
+| `isPrivate` | `boolean` | |
+| `calendarEventId` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+#### Calls Get
+
+Get specific call data by ID
+
+**Python SDK**
+
+```python
+gong.calls.get(
+ id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "calls",
+ "action": "get",
+ "params": {
+ "id": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `string` | Yes | Call ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `url` | `string` | |
+| `title` | `string` | |
+| `scheduled` | `string` | |
+| `started` | `string` | |
+| `duration` | `integer` | |
+| `primaryUserId` | `string` | |
+| `direction` | `string` | |
+| `system` | `string` | |
+| `scope` | `string` | |
+| `media` | `string` | |
+| `language` | `string` | |
+| `workspaceId` | `string` | |
+| `sdrDisposition` | `string \| null` | |
+| `clientUniqueId` | `string \| null` | |
+| `customData` | `string \| null` | |
+| `purpose` | `string \| null` | |
+| `meetingUrl` | `string` | |
+| `isPrivate` | `boolean` | |
+| `calendarEventId` | `string \| null` | |
+
+
+
+
+### Calls Extensive
+
+#### Calls Extensive List
+
+Retrieve detailed call data including participants, interaction stats, and content
+
+**Python SDK**
+
+```python
+gong.calls_extensive.list(
+ filter={}
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "calls_extensive",
+ "action": "list",
+ "params": {
+ "filter": {}
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | Yes | |
+| `filter.fromDateTime` | `string` | No | Start date in ISO 8601 format |
+| `filter.toDateTime` | `string` | No | End date in ISO 8601 format |
+| `filter.callIds` | `array` | No | List of specific call IDs to retrieve |
+| `filter.workspaceId` | `string` | No | Filter by workspace ID |
+| `contentSelector` | `object` | No | Select which content to include in the response |
+| `contentSelector.context` | `"Extended"` | No | Context level for the data |
+| `contentSelector.contextTiming` | `array<"Now" \| "TimeOfCall">` | No | Context timing options |
+| `contentSelector.exposedFields` | `object` | No | Specify which fields to include in the response |
+| `contentSelector.exposedFields.collaboration` | `object` | No | |
+| `contentSelector.exposedFields.collaboration.publicComments` | `boolean` | No | Include public comments |
+| `contentSelector.exposedFields.content` | `object` | No | |
+| `contentSelector.exposedFields.content.pointsOfInterest` | `boolean` | No | Include points of interest (deprecated, use highlights) |
+| `contentSelector.exposedFields.content.structure` | `boolean` | No | Include call structure |
+| `contentSelector.exposedFields.content.topics` | `boolean` | No | Include topics discussed |
+| `contentSelector.exposedFields.content.trackers` | `boolean` | No | Include trackers |
+| `contentSelector.exposedFields.content.trackerOccurrences` | `boolean` | No | Include tracker occurrences |
+| `contentSelector.exposedFields.content.brief` | `boolean` | No | Include call brief |
+| `contentSelector.exposedFields.content.outline` | `boolean` | No | Include call outline |
+| `contentSelector.exposedFields.content.highlights` | `boolean` | No | Include call highlights |
+| `contentSelector.exposedFields.content.callOutcome` | `boolean` | No | Include call outcome |
+| `contentSelector.exposedFields.content.keyPoints` | `boolean` | No | Include key points |
+| `contentSelector.exposedFields.interaction` | `object` | No | |
+| `contentSelector.exposedFields.interaction.personInteractionStats` | `boolean` | No | Include person interaction statistics |
+| `contentSelector.exposedFields.interaction.questions` | `boolean` | No | Include questions asked |
+| `contentSelector.exposedFields.interaction.speakers` | `boolean` | No | Include speaker information |
+| `contentSelector.exposedFields.interaction.video` | `boolean` | No | Include video interaction data |
+| `contentSelector.exposedFields.media` | `boolean` | No | Include media URLs (audio/video) |
+| `contentSelector.exposedFields.parties` | `boolean` | No | Include participant information |
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `metaData` | `object` | |
+| `parties` | `array` | |
+| `interaction` | `object` | |
+| `collaboration` | `object` | |
+| `content` | `object` | |
+| `media` | `object` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Call Audio
+
+#### Call Audio Download
+
+Downloads the audio media file for a call. Temporarily, the request body must be configured with:
+`{"filter": {"callIds": [CALL_ID]}, "contentSelector": {"exposedFields": {"media": true}}}`
+
+
+**Python SDK**
+
+```python
+async for chunk in gong.call_audio.download():# Process each chunk (e.g., write to file)
+ file.write(chunk)
+```
+
+> **Note**: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use `async for` to process chunks as they arrive.
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "call_audio",
+ "action": "download"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.callIds` | `array` | No | List containing the single call ID |
+| `contentSelector` | `object` | No | |
+| `contentSelector.exposedFields` | `object` | No | |
+| `contentSelector.exposedFields.media` | `boolean` | No | Must be true to get media URLs |
+| `range_header` | `string` | No | Optional Range header for partial downloads (e.g., 'bytes=0-99') |
+
+
+### Call Video
+
+#### Call Video Download
+
+Downloads the video media file for a call. Temporarily, the request body must be configured with:
+`{"filter": {"callIds": [CALL_ID]}, "contentSelector": {"exposedFields": {"media": true}}}`
+
+
+**Python SDK**
+
+```python
+async for chunk in gong.call_video.download():# Process each chunk (e.g., write to file)
+ file.write(chunk)
+```
+
+> **Note**: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use `async for` to process chunks as they arrive.
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "call_video",
+ "action": "download"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.callIds` | `array` | No | List containing the single call ID |
+| `contentSelector` | `object` | No | |
+| `contentSelector.exposedFields` | `object` | No | |
+| `contentSelector.exposedFields.media` | `boolean` | No | Must be true to get media URLs |
+| `range_header` | `string` | No | Optional Range header for partial downloads (e.g., 'bytes=0-99') |
+
+
+### Workspaces
+
+#### Workspaces List
+
+List all company workspaces
+
+**Python SDK**
+
+```python
+gong.workspaces.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "workspaces",
+ "action": "list"
+}'
+```
+
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `workspaceId` | `string` | |
+| `name` | `string` | |
+| `description` | `string` | |
+
+
+
+
+### Call Transcripts
+
+#### Call Transcripts List
+
+Returns transcripts for calls in a specified date range or specific call IDs
+
+**Python SDK**
+
+```python
+gong.call_transcripts.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "call_transcripts",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.fromDateTime` | `string` | No | Start date in ISO 8601 format (optional if callIds provided) |
+| `filter.toDateTime` | `string` | No | End date in ISO 8601 format (optional if callIds provided) |
+| `filter.callIds` | `array` | No | List of specific call IDs to retrieve transcripts for |
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `callId` | `string` | |
+| `transcript` | `array` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Stats Activity Aggregate
+
+#### Stats Activity Aggregate List
+
+Provides aggregated user activity metrics across a specified period
+
+**Python SDK**
+
+```python
+gong.stats_activity_aggregate.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "stats_activity_aggregate",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.fromDate` | `string` | No | Start date (YYYY-MM-DD) |
+| `filter.toDate` | `string` | No | End date (YYYY-MM-DD) |
+| `filter.userIds` | `array` | No | List of user IDs to retrieve stats for |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `userId` | `string` | |
+| `userEmailAddress` | `string` | |
+| `userAggregateActivityStats` | `object` | |
+| `userAggregateActivityStats.callsAsHost` | `integer` | |
+| `userAggregateActivityStats.callsGaveFeedback` | `integer` | |
+| `userAggregateActivityStats.callsRequestedFeedback` | `integer` | |
+| `userAggregateActivityStats.callsReceivedFeedback` | `integer` | |
+| `userAggregateActivityStats.ownCallsListenedTo` | `integer` | |
+| `userAggregateActivityStats.othersCallsListenedTo` | `integer` | |
+| `userAggregateActivityStats.callsSharedInternally` | `integer` | |
+| `userAggregateActivityStats.callsSharedExternally` | `integer` | |
+| `userAggregateActivityStats.callsScorecardsFilled` | `integer` | |
+| `userAggregateActivityStats.callsScorecardsReceived` | `integer` | |
+| `userAggregateActivityStats.callsAttended` | `integer` | |
+| `userAggregateActivityStats.callsCommentsGiven` | `integer` | |
+| `userAggregateActivityStats.callsCommentsReceived` | `integer` | |
+| `userAggregateActivityStats.callsMarkedAsFeedbackGiven` | `integer` | |
+| `userAggregateActivityStats.callsMarkedAsFeedbackReceived` | `integer` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Stats Activity Day By Day
+
+#### Stats Activity Day By Day List
+
+Delivers daily user activity metrics across a specified date range
+
+**Python SDK**
+
+```python
+gong.stats_activity_day_by_day.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "stats_activity_day_by_day",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.fromDate` | `string` | No | Start date (YYYY-MM-DD) |
+| `filter.toDate` | `string` | No | End date (YYYY-MM-DD) |
+| `filter.userIds` | `array` | No | List of user IDs to retrieve stats for |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `userId` | `string` | |
+| `userEmailAddress` | `string` | |
+| `userDailyActivityStats` | `array` | |
+| `userDailyActivityStats[].callsAsHost` | `array` | |
+| `userDailyActivityStats[].callsGaveFeedback` | `array` | |
+| `userDailyActivityStats[].callsRequestedFeedback` | `array` | |
+| `userDailyActivityStats[].callsReceivedFeedback` | `array` | |
+| `userDailyActivityStats[].ownCallsListenedTo` | `array` | |
+| `userDailyActivityStats[].othersCallsListenedTo` | `array` | |
+| `userDailyActivityStats[].callsSharedInternally` | `array` | |
+| `userDailyActivityStats[].callsSharedExternally` | `array` | |
+| `userDailyActivityStats[].callsAttended` | `array` | |
+| `userDailyActivityStats[].callsCommentsGiven` | `array` | |
+| `userDailyActivityStats[].callsCommentsReceived` | `array` | |
+| `userDailyActivityStats[].callsMarkedAsFeedbackGiven` | `array` | |
+| `userDailyActivityStats[].callsMarkedAsFeedbackReceived` | `array` | |
+| `userDailyActivityStats[].callsScorecardsFilled` | `array` | |
+| `userDailyActivityStats[].callsScorecardsReceived` | `array` | |
+| `userDailyActivityStats[].fromDate` | `string` | |
+| `userDailyActivityStats[].toDate` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Stats Interaction
+
+#### Stats Interaction List
+
+Returns interaction stats for users based on calls that have Whisper turned on
+
+**Python SDK**
+
+```python
+gong.stats_interaction.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "stats_interaction",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.fromDate` | `string` | No | Start date (YYYY-MM-DD) |
+| `filter.toDate` | `string` | No | End date (YYYY-MM-DD) |
+| `filter.userIds` | `array` | No | List of user IDs to retrieve stats for |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `userId` | `string` | |
+| `userEmailAddress` | `string` | |
+| `personInteractionStats` | `array` | |
+| `personInteractionStats[].name` | `string` | |
+| `personInteractionStats[].value` | `number` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Settings Scorecards
+
+#### Settings Scorecards List
+
+Retrieve all scorecard configurations in the company
+
+**Python SDK**
+
+```python
+gong.settings_scorecards.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "settings_scorecards",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspaceId` | `string` | No | Filter scorecards by workspace ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `scorecardId` | `string` | |
+| `scorecardName` | `string` | |
+| `workspaceId` | `string \| null` | |
+| `enabled` | `boolean` | |
+| `updaterUserId` | `string` | |
+| `created` | `string` | |
+| `updated` | `string` | |
+| `reviewMethod` | `string` | |
+| `questions` | `array` | |
+| `questions[].questionId` | `string` | |
+| `questions[].questionRevisionId` | `string` | |
+| `questions[].questionText` | `string` | |
+| `questions[].questionType` | `string` | |
+| `questions[].isRequired` | `boolean` | |
+| `questions[].isOverall` | `boolean` | |
+| `questions[].updaterUserId` | `string` | |
+| `questions[].answerGuide` | `string \| null` | |
+| `questions[].minRange` | `string \| null` | |
+| `questions[].maxRange` | `string \| null` | |
+| `questions[].created` | `string` | |
+| `questions[].updated` | `string` | |
+| `questions[].answerOptions` | `array` | |
+
+
+
+
+### Settings Trackers
+
+#### Settings Trackers List
+
+Retrieve all keyword tracker configurations in the company
+
+**Python SDK**
+
+```python
+gong.settings_trackers.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "settings_trackers",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspaceId` | `string` | No | Filter trackers by workspace ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `trackerId` | `string` | |
+| `trackerName` | `string` | |
+| `workspaceId` | `string \| null` | |
+| `languageKeywords` | `array` | |
+| `affiliation` | `string` | |
+| `partOfQuestion` | `boolean` | |
+| `saidAt` | `string` | |
+| `saidAtInterval` | `string \| null` | |
+| `saidAtUnit` | `string \| null` | |
+| `saidInTopics` | `array` | |
+| `filterQuery` | `string` | |
+| `created` | `string` | |
+| `creatorUserId` | `string \| null` | |
+| `updated` | `string` | |
+| `updaterUserId` | `string \| null` | |
+
+
+
+
+### Library Folders
+
+#### Library Folders List
+
+Retrieve the folder structure of the call library
+
+**Python SDK**
+
+```python
+gong.library_folders.list(
+ workspace_id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "library_folders",
+ "action": "list",
+ "params": {
+ "workspaceId": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspaceId` | `string` | Yes | Workspace ID to retrieve folders from |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `name` | `string` | |
+| `parentFolderId` | `string \| null` | |
+| `createdBy` | `string \| null` | |
+| `updated` | `string` | |
+
+
+
+
+### Library Folder Content
+
+#### Library Folder Content List
+
+Retrieve calls in a specific library folder
+
+**Python SDK**
+
+```python
+gong.library_folder_content.list(
+ folder_id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "library_folder_content",
+ "action": "list",
+ "params": {
+ "folderId": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `folderId` | `string` | Yes | Folder ID to retrieve content from |
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `callId` | `string` | |
+| `title` | `string` | |
+| `started` | `string` | |
+| `duration` | `integer` | |
+| `primaryUserId` | `string` | |
+| `url` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+### Coaching
+
+#### Coaching List
+
+Retrieve coaching metrics for a manager and their direct reports
+
+**Python SDK**
+
+```python
+gong.coaching.list(
+ workspace_id="",
+ manager_id="",
+ from_="2025-01-01T00:00:00Z",
+ to="2025-01-01T00:00:00Z"
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "coaching",
+ "action": "list",
+ "params": {
+ "workspace-id": "",
+ "manager-id": "",
+ "from": "2025-01-01T00:00:00Z",
+ "to": "2025-01-01T00:00:00Z"
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `workspace-id` | `string` | Yes | Workspace ID |
+| `manager-id` | `string` | Yes | Manager user ID |
+| `from` | `string` | Yes | Start date in ISO 8601 format |
+| `to` | `string` | Yes | End date in ISO 8601 format |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `userId` | `string` | |
+| `userEmailAddress` | `string` | |
+| `userName` | `string` | |
+| `isManager` | `boolean` | |
+| `coachingMetrics` | `object` | |
+| `coachingMetrics.callsListened` | `integer` | |
+| `coachingMetrics.callsAttended` | `integer` | |
+| `coachingMetrics.callsWithFeedback` | `integer` | |
+| `coachingMetrics.callsWithComments` | `integer` | |
+| `coachingMetrics.scorecardsFilled` | `integer` | |
+
+
+
+
+### Stats Activity Scorecards
+
+#### Stats Activity Scorecards List
+
+Retrieve answered scorecards for applicable reviewed users or scorecards for a date range
+
+**Python SDK**
+
+```python
+gong.stats_activity_scorecards.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "stats_activity_scorecards",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filter` | `object` | No | |
+| `filter.fromDateTime` | `string` | No | Start date in ISO 8601 format |
+| `filter.toDateTime` | `string` | No | End date in ISO 8601 format |
+| `filter.scorecardIds` | `array` | No | List of scorecard IDs to filter by |
+| `filter.reviewedUserIds` | `array` | No | List of reviewed user IDs to filter by |
+| `filter.reviewerUserIds` | `array` | No | List of reviewer user IDs to filter by |
+| `filter.callIds` | `array` | No | List of call IDs to filter by |
+| `cursor` | `string` | No | Cursor for pagination |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `answeredScorecardId` | `string` | |
+| `scorecardId` | `string` | |
+| `scorecardName` | `string` | |
+| `callId` | `string` | |
+| `callStartTime` | `string` | |
+| `reviewedUserId` | `string` | |
+| `reviewerUserId` | `string` | |
+| `reviewMethod` | `string` | |
+| `editorUserId` | `string \| null` | |
+| `answeredDateTime` | `string` | |
+| `reviewTime` | `string` | |
+| `visibilityType` | `string` | |
+| `answers` | `array` | |
+| `answers[].questionId` | `string` | |
+| `answers[].questionRevisionId` | `string` | |
+| `answers[].isOverall` | `boolean` | |
+| `answers[].answer` | `string` | |
+| `answers[].answerText` | `string \| null` | |
+| `answers[].score` | `number` | |
+| `answers[].notApplicable` | `boolean` | |
+| `answers[].selectedOptions` | `array \| null` | |
+| `overallScore` | `number` | |
+| `visibility` | `string` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `pagination` | `object` | |
+| `pagination.totalRecords` | `integer` | |
+| `pagination.currentPageSize` | `integer` | |
+| `pagination.currentPageNumber` | `integer` | |
+| `pagination.cursor` | `string` | |
+
+
+
+
+
+## Authentication
+
+The Gong connector supports the following authentication methods:
+
+
+### Access Key Authentication
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `access_key` | `str` | Yes | Your Gong API Access Key |
+| `access_key_secret` | `str` | Yes | Your Gong API Access Key Secret |
+
+#### Example
+
+**Python SDK**
+
+```python
+GongConnector(
+ auth_config=GongAuthConfig(
+ access_key="",
+ access_key_secret=""
+ )
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "connector_definition_id": "32382e40-3b49-4b99-9c5c-4076501914e7",
+ "auth_config": {
+ "access_key": "",
+ "access_key_secret": ""
+ },
+ "name": "My Gong Connector"
+}'
+```
+
diff --git a/docs/ai-agents/connectors/greenhouse/CHANGELOG.md b/docs/ai-agents/connectors/greenhouse/CHANGELOG.md
new file mode 100644
index 00000000000..b91daa56819
--- /dev/null
+++ b/docs/ai-agents/connectors/greenhouse/CHANGELOG.md
@@ -0,0 +1,136 @@
+# Changelog
+
+## [0.17.10] - 2025-12-13
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.17.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 4d366cb5
+- SDK version: 0.1.0
+
+## [0.17.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.17.7] - 2025-12-12
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.17.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.17.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.17.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.17.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.17.2] - 2025-12-11
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.17.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.17.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.16.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4c17f060
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: b261c3a2
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/greenhouse/README.md b/docs/ai-agents/connectors/greenhouse/README.md
new file mode 100644
index 00000000000..c1b3821b52d
--- /dev/null
+++ b/docs/ai-agents/connectors/greenhouse/README.md
@@ -0,0 +1,78 @@
+# Airbyte Greenhouse AI Connector
+
+Greenhouse is an applicant tracking system (ATS) that helps companies manage their
+hiring process. This connector provides access to candidates, applications, jobs,
+offers, users, departments, offices, job posts, sources, and scheduled interviews
+for recruiting analytics and talent acquisition insights.
+
+
+## Example Questions
+
+- Show me candidates from [Company] who applied last month
+- What are the top 5 sources for our job applications this quarter?
+- List all open jobs in the Sales department
+- Analyze the interview schedules for our engineering candidates this week
+- Get details of recent job offers for [teamMember]
+- Compare the number of applications across different offices
+- Identify candidates who have multiple applications in our system
+- Show me upcoming scheduled interviews for our marketing positions
+- Summarize the candidate pipeline for our latest job posting
+- Find the most active departments in recruiting this month
+
+## Unsupported Questions
+
+- Create a new job posting for the marketing team
+- Schedule an interview for [candidate]
+- Update the status of [candidate]'s application
+- Delete a candidate profile
+- Send an offer letter to [candidate]
+- Edit the details of a job description
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-greenhouse
+```
+
+## Usage
+
+```python
+from airbyte_ai_greenhouse import GreenhouseConnector, GreenhouseAuthConfig
+
+connector = GreenhouseConnector(
+ auth_config=GreenhouseAuthConfig(
+ api_key="..."
+ )
+)
+result = connector.candidates.list()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Candidates | [List](./REFERENCE.md#candidates-list), [Get](./REFERENCE.md#candidates-get) |
+| Applications | [List](./REFERENCE.md#applications-list), [Get](./REFERENCE.md#applications-get) |
+| Jobs | [List](./REFERENCE.md#jobs-list), [Get](./REFERENCE.md#jobs-get) |
+| Offers | [List](./REFERENCE.md#offers-list), [Get](./REFERENCE.md#offers-get) |
+| Users | [List](./REFERENCE.md#users-list), [Get](./REFERENCE.md#users-get) |
+| Departments | [List](./REFERENCE.md#departments-list), [Get](./REFERENCE.md#departments-get) |
+| Offices | [List](./REFERENCE.md#offices-list), [Get](./REFERENCE.md#offices-get) |
+| Job Posts | [List](./REFERENCE.md#job-posts-list), [Get](./REFERENCE.md#job-posts-get) |
+| Sources | [List](./REFERENCE.md#sources-list) |
+| Scheduled Interviews | [List](./REFERENCE.md#scheduled-interviews-list), [Get](./REFERENCE.md#scheduled-interviews-get) |
+| Application Attachment | [Download](./REFERENCE.md#application-attachment-download) |
+| Candidate Attachment | [Download](./REFERENCE.md#candidate-attachment-download) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Greenhouse API Reference](https://developers.greenhouse.io/harvest.html).
+
+## Version Information
+
+**Package Version:** 0.17.10
+
+**Connector Version:** 0.1.1
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb
\ No newline at end of file
diff --git a/docs/ai-agents/connectors/greenhouse/REFERENCE.md b/docs/ai-agents/connectors/greenhouse/REFERENCE.md
new file mode 100644
index 00000000000..fe527119af6
--- /dev/null
+++ b/docs/ai-agents/connectors/greenhouse/REFERENCE.md
@@ -0,0 +1,1048 @@
+# Greenhouse
+
+## Supported Entities and Actions
+
+| Entity | Actions |
+|--------|---------|
+| Candidates | [List](#candidates-list), [Get](#candidates-get) |
+| Applications | [List](#applications-list), [Get](#applications-get) |
+| Jobs | [List](#jobs-list), [Get](#jobs-get) |
+| Offers | [List](#offers-list), [Get](#offers-get) |
+| Users | [List](#users-list), [Get](#users-get) |
+| Departments | [List](#departments-list), [Get](#departments-get) |
+| Offices | [List](#offices-list), [Get](#offices-get) |
+| Job Posts | [List](#job-posts-list), [Get](#job-posts-get) |
+| Sources | [List](#sources-list) |
+| Scheduled Interviews | [List](#scheduled-interviews-list), [Get](#scheduled-interviews-get) |
+| Application Attachment | [Download](#application-attachment-download) |
+| Candidate Attachment | [Download](#candidate-attachment-download) |
+
+### Candidates
+
+#### Candidates List
+
+Returns a paginated list of all candidates in the organization
+
+**Python SDK**
+
+```python
+greenhouse.candidates.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "candidates",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+
+
+#### Candidates Get
+
+Get a single candidate by ID
+
+**Python SDK**
+
+```python
+greenhouse.candidates.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "candidates",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Candidate ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `first_name` | `string` | |
+| `last_name` | `string` | |
+| `company` | `string \| null` | |
+| `title` | `string \| null` | |
+| `created_at` | `string` | |
+| `updated_at` | `string` | |
+| `last_activity` | `string` | |
+| `is_private` | `boolean` | |
+| `photo_url` | `string \| null` | |
+| `attachments` | `array` | |
+| `attachments[].filename` | `string` | |
+| `attachments[].url` | `string` | |
+| `attachments[].type` | `"resume" \| "cover_letter" \| "admin_only" \| "take_home_test" \| "offer_packet" \| "offer_letter" \| "signed_offer_letter" \| "other"` | |
+| `attachments[].created_at` | `string` | |
+| `application_ids` | `array` | |
+| `phone_numbers` | `array` | |
+| `addresses` | `array` | |
+| `email_addresses` | `array` | |
+| `website_addresses` | `array` | |
+| `social_media_addresses` | `array` | |
+| `recruiter` | `object \| null` | |
+| `coordinator` | `object \| null` | |
+| `can_email` | `boolean` | |
+| `tags` | `array` | |
+| `custom_fields` | `object` | |
+
+
+
+
+### Applications
+
+#### Applications List
+
+Returns a paginated list of all applications
+
+**Python SDK**
+
+```python
+greenhouse.applications.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "applications",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+| `created_before` | `string` | No | Filter by applications created before this timestamp |
+| `created_after` | `string` | No | Filter by applications created after this timestamp |
+| `last_activity_after` | `string` | No | Filter by applications with activity after this timestamp |
+| `job_id` | `integer` | No | Filter by job ID |
+| `status` | `"active" \| "rejected" \| "hired"` | No | Filter by application status |
+
+
+#### Applications Get
+
+Get a single application by ID
+
+**Python SDK**
+
+```python
+greenhouse.applications.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "applications",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Application ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `candidate_id` | `integer` | |
+| `prospect` | `boolean` | |
+| `applied_at` | `string` | |
+| `rejected_at` | `string \| null` | |
+| `last_activity_at` | `string` | |
+| `location` | `object \| null` | |
+| `source` | `object` | |
+| `credited_to` | `object` | |
+| `rejection_reason` | `object \| null` | |
+| `rejection_details` | `object \| null` | |
+| `jobs` | `array` | |
+| `job_post_id` | `integer \| null` | |
+| `status` | `string` | |
+| `current_stage` | `object \| null` | |
+| `answers` | `array` | |
+| `prospective_office` | `object \| null` | |
+| `prospective_department` | `object \| null` | |
+| `prospect_detail` | `object` | |
+| `attachments` | `array` | |
+| `attachments[].filename` | `string` | |
+| `attachments[].url` | `string` | |
+| `attachments[].type` | `"resume" \| "cover_letter" \| "admin_only" \| "take_home_test" \| "offer_packet" \| "offer_letter" \| "signed_offer_letter" \| "other"` | |
+| `attachments[].created_at` | `string` | |
+| `custom_fields` | `object` | |
+
+
+
+
+### Jobs
+
+#### Jobs List
+
+Returns a paginated list of all jobs in the organization
+
+**Python SDK**
+
+```python
+greenhouse.jobs.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "jobs",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+
+
+#### Jobs Get
+
+Get a single job by ID
+
+**Python SDK**
+
+```python
+greenhouse.jobs.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "jobs",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Job ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `name` | `string` | |
+| `requisition_id` | `string \| null` | |
+| `notes` | `string \| null` | |
+| `confidential` | `boolean` | |
+| `status` | `string` | |
+| `created_at` | `string` | |
+| `opened_at` | `string` | |
+| `closed_at` | `string \| null` | |
+| `updated_at` | `string` | |
+| `departments` | `array` | |
+| `offices` | `array` | |
+| `custom_fields` | `object` | |
+| `hiring_team` | `object` | |
+| `openings` | `array` | |
+
+
+
+
+### Offers
+
+#### Offers List
+
+Returns a paginated list of all offers
+
+**Python SDK**
+
+```python
+greenhouse.offers.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "offers",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+| `created_before` | `string` | No | Filter by offers created before this timestamp |
+| `created_after` | `string` | No | Filter by offers created after this timestamp |
+| `resolved_after` | `string` | No | Filter by offers resolved after this timestamp |
+
+
+#### Offers Get
+
+Get a single offer by ID
+
+**Python SDK**
+
+```python
+greenhouse.offers.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "offers",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Offer ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `version` | `integer` | |
+| `application_id` | `integer` | |
+| `job_id` | `integer` | |
+| `candidate_id` | `integer` | |
+| `opening` | `object \| null` | |
+| `created_at` | `string` | |
+| `updated_at` | `string` | |
+| `sent_at` | `string \| null` | |
+| `resolved_at` | `string \| null` | |
+| `starts_at` | `string \| null` | |
+| `status` | `string` | |
+| `custom_fields` | `object` | |
+
+
+
+
+### Users
+
+#### Users List
+
+Returns a paginated list of all users
+
+**Python SDK**
+
+```python
+greenhouse.users.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+| `created_before` | `string` | No | Filter by users created before this timestamp |
+| `created_after` | `string` | No | Filter by users created after this timestamp |
+| `updated_before` | `string` | No | Filter by users updated before this timestamp |
+| `updated_after` | `string` | No | Filter by users updated after this timestamp |
+
+
+#### Users Get
+
+Get a single user by ID
+
+**Python SDK**
+
+```python
+greenhouse.users.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "users",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | User ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `name` | `string` | |
+| `first_name` | `string` | |
+| `last_name` | `string` | |
+| `primary_email_address` | `string` | |
+| `updated_at` | `string` | |
+| `created_at` | `string` | |
+| `disabled` | `boolean` | |
+| `site_admin` | `boolean` | |
+| `emails` | `array` | |
+| `employee_id` | `string \| null` | |
+| `linked_candidate_ids` | `array` | |
+| `offices` | `array` | |
+| `departments` | `array` | |
+
+
+
+
+### Departments
+
+#### Departments List
+
+Returns a paginated list of all departments
+
+**Python SDK**
+
+```python
+greenhouse.departments.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "departments",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+
+
+#### Departments Get
+
+Get a single department by ID
+
+**Python SDK**
+
+```python
+greenhouse.departments.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "departments",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Department ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `name` | `string` | |
+| `parent_id` | `integer \| null` | |
+| `parent_department_external_id` | `string \| null` | |
+| `child_ids` | `array` | |
+| `child_department_external_ids` | `array` | |
+| `external_id` | `string \| null` | |
+
+
+
+
+### Offices
+
+#### Offices List
+
+Returns a paginated list of all offices
+
+**Python SDK**
+
+```python
+greenhouse.offices.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "offices",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+
+
+#### Offices Get
+
+Get a single office by ID
+
+**Python SDK**
+
+```python
+greenhouse.offices.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "offices",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Office ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `name` | `string` | |
+| `location` | `object \| null` | |
+| `primary_contact_user_id` | `integer \| null` | |
+| `parent_id` | `integer \| null` | |
+| `parent_office_external_id` | `string \| null` | |
+| `child_ids` | `array` | |
+| `child_office_external_ids` | `array` | |
+| `external_id` | `string \| null` | |
+
+
+
+
+### Job Posts
+
+#### Job Posts List
+
+Returns a paginated list of all job posts
+
+**Python SDK**
+
+```python
+greenhouse.job_posts.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "job_posts",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+| `live` | `boolean` | No | Filter by live status |
+| `active` | `boolean` | No | Filter by active status |
+
+
+#### Job Posts Get
+
+Get a single job post by ID
+
+**Python SDK**
+
+```python
+greenhouse.job_posts.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "job_posts",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Job Post ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `title` | `string` | |
+| `location` | `object \| null` | |
+| `internal` | `boolean` | |
+| `external` | `boolean` | |
+| `active` | `boolean` | |
+| `live` | `boolean` | |
+| `first_published_at` | `string \| null` | |
+| `job_id` | `integer` | |
+| `content` | `string \| null` | |
+| `internal_content` | `string \| null` | |
+| `updated_at` | `string` | |
+| `created_at` | `string` | |
+| `demographic_question_set_id` | `integer \| null` | |
+| `questions` | `array` | |
+
+
+
+
+### Sources
+
+#### Sources List
+
+Returns a paginated list of all sources
+
+**Python SDK**
+
+```python
+greenhouse.sources.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "sources",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+
+
+### Scheduled Interviews
+
+#### Scheduled Interviews List
+
+Returns a paginated list of all scheduled interviews
+
+**Python SDK**
+
+```python
+greenhouse.scheduled_interviews.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "scheduled_interviews",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `per_page` | `integer` | No | Number of items to return per page (max 500) |
+| `page` | `integer` | No | Page number for pagination |
+| `created_before` | `string` | No | Filter by interviews created before this timestamp |
+| `created_after` | `string` | No | Filter by interviews created after this timestamp |
+| `updated_before` | `string` | No | Filter by interviews updated before this timestamp |
+| `updated_after` | `string` | No | Filter by interviews updated after this timestamp |
+| `starts_after` | `string` | No | Filter by interviews starting after this timestamp |
+| `ends_before` | `string` | No | Filter by interviews ending before this timestamp |
+
+
+#### Scheduled Interviews Get
+
+Get a single scheduled interview by ID
+
+**Python SDK**
+
+```python
+greenhouse.scheduled_interviews.get(
+ id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "scheduled_interviews",
+ "action": "get",
+ "params": {
+ "id": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Scheduled Interview ID |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `integer` | |
+| `application_id` | `integer` | |
+| `external_event_id` | `string \| null` | |
+| `created_at` | `string` | |
+| `updated_at` | `string` | |
+| `start` | `object \| null` | |
+| `end` | `object \| null` | |
+| `location` | `string \| null` | |
+| `video_conferencing_url` | `string \| null` | |
+| `status` | `string` | |
+| `interview` | `object \| null` | |
+| `organizer` | `object \| null` | |
+| `interviewers` | `array` | |
+
+
+
+
+### Application Attachment
+
+#### Application Attachment Download
+
+Downloads an attachment (resume, cover letter, etc.) for an application by index.
+The attachment URL is a temporary signed AWS S3 URL that expires within 7 days.
+Files should be downloaded immediately after retrieval.
+
+
+**Python SDK**
+
+```python
+async for chunk in greenhouse.application_attachment.download( id=0, attachment_index=0):# Process each chunk (e.g., write to file)
+ file.write(chunk)
+```
+
+> **Note**: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use `async for` to process chunks as they arrive.
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "application_attachment",
+ "action": "download",
+ "params": {
+ "id": 0,
+ "attachment_index": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Application ID |
+| `attachment_index` | `integer` | Yes | Index of the attachment to download (0-based) |
+| `range_header` | `string` | No | Optional Range header for partial downloads (e.g., 'bytes=0-99') |
+
+
+### Candidate Attachment
+
+#### Candidate Attachment Download
+
+Downloads an attachment (resume, cover letter, etc.) for a candidate by index.
+The attachment URL is a temporary signed AWS S3 URL that expires within 7 days.
+Files should be downloaded immediately after retrieval.
+
+
+**Python SDK**
+
+```python
+async for chunk in greenhouse.candidate_attachment.download( id=0, attachment_index=0):# Process each chunk (e.g., write to file)
+ file.write(chunk)
+```
+
+> **Note**: Download operations return an async iterator of bytes chunks for memory-efficient streaming. Use `async for` to process chunks as they arrive.
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "candidate_attachment",
+ "action": "download",
+ "params": {
+ "id": 0,
+ "attachment_index": 0
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `id` | `integer` | Yes | Candidate ID |
+| `attachment_index` | `integer` | Yes | Index of the attachment to download (0-based) |
+| `range_header` | `string` | No | Optional Range header for partial downloads (e.g., 'bytes=0-99') |
+
+
+
+
+## Authentication
+
+The Greenhouse connector supports the following authentication methods:
+
+
+### Harvest API Key Authentication
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Greenhouse Harvest API Key from the Dev Center |
+
+#### Example
+
+**Python SDK**
+
+```python
+GreenhouseConnector(
+ auth_config=GreenhouseAuthConfig(
+ api_key=""
+ )
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "connector_definition_id": "59f1e50a-331f-4f09-b3e8-2e8d4d355f44",
+ "auth_config": {
+ "api_key": ""
+ },
+ "name": "My Greenhouse Connector"
+}'
+```
+
diff --git a/docs/ai-agents/connectors/hubspot/CHANGELOG.md b/docs/ai-agents/connectors/hubspot/CHANGELOG.md
new file mode 100644
index 00000000000..c5b461a92d7
--- /dev/null
+++ b/docs/ai-agents/connectors/hubspot/CHANGELOG.md
@@ -0,0 +1,131 @@
+# Changelog
+
+## [0.15.11] - 2025-12-13
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 1ab72bd8
+- SDK version: 0.1.0
+
+## [0.15.10] - 2025-12-12
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 4d366cb5
+- SDK version: 0.1.0
+
+## [0.15.9] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: dc79dc8b
+- SDK version: 0.1.0
+
+## [0.15.8] - 2025-12-12
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 9f7f8a98
+- SDK version: 0.1.0
+
+## [0.15.7] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 8c06aa10
+- SDK version: 0.1.0
+
+## [0.15.6] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 11427ac3
+- SDK version: 0.1.0
+
+## [0.15.5] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: bdd5df6d
+- SDK version: 0.1.0
+
+## [0.15.4] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: f2497f71
+- SDK version: 0.1.0
+
+## [0.15.3] - 2025-12-11
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 7d738be5
+- SDK version: 0.1.0
+
+## [0.15.2] - 2025-12-10
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 76636830
+- SDK version: 0.1.0
+
+## [0.15.1] - 2025-12-10
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 32ed3114
+- SDK version: 0.1.0
+
+## [0.15.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: f2ad5029
+- SDK version: 0.1.0
+
+## [0.14.0] - 2025-12-08
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: 139b0b0d
+- SDK version: 0.1.0
+
+## [0.13.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: e96bed3d
+- SDK version: 0.1.0
+
+## [0.12.0] - 2025-12-05
+- Updated connector definition (YAML version 0.1.0)
+- Source commit: ed697b90
+- SDK version: 0.1.0
+
+## [0.11.0] - 2025-12-05
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 20618410
+- SDK version: 0.1.0
+
+## [0.10.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 4a01e446
+- SDK version: 0.1.0
+
+## [0.9.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 5ec76dde
+- SDK version: 0.1.0
+
+## [0.8.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: df32a458
+- SDK version: 0.1.0
+
+## [0.7.0] - 2025-12-04
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: a506b369
+- SDK version: 0.1.0
+
+## [0.6.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 92a39ab5
+- SDK version: 0.1.0
+
+## [0.5.0] - 2025-12-03
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 0ce38253
+- SDK version: 0.1.0
+
+## [0.4.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: c8e326d9
+- SDK version: 0.1.0
+
+## [0.3.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: ad0b961b
+- SDK version: 0.1.0
+
+## [0.2.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 7153780a
+- SDK version: 0.1.0
+
+## [0.1.0] - 2025-12-02
+- Updated connector definition (YAML version 1.0.0)
+- Source commit: 01f71cad
+- SDK version: 0.1.0
diff --git a/docs/ai-agents/connectors/hubspot/README.md b/docs/ai-agents/connectors/hubspot/README.md
new file mode 100644
index 00000000000..a75180982dc
--- /dev/null
+++ b/docs/ai-agents/connectors/hubspot/README.md
@@ -0,0 +1,71 @@
+# Airbyte Hubspot AI Connector
+
+HubSpot is a CRM platform that provides tools for marketing, sales, customer service,
+and content management. This connector provides access to contacts, companies, deals,
+tickets, and custom objects for customer relationship management and sales analytics.
+
+
+## Example Questions
+
+- Show me all deals from [Company] this quarter
+- What are the top 5 most valuable deals in my pipeline right now?
+- List recent tickets from [customerX] and analyze their support trends
+- Search for contacts in the marketing department at [Company]
+- Give me an overview of my sales team's deals in the last 30 days
+- Identify the most active companies in our CRM this month
+- Compare the number of deals closed by different sales representatives
+- Find all tickets related to a specific product issue and summarize their status
+
+## Unsupported Questions
+
+- Create a new contact record for [personX]
+- Update the contact information for [customerY]
+- Delete the ticket from last week's support case
+- Schedule a follow-up task for this deal
+- Send an email to all contacts in the sales pipeline
+
+## Installation
+
+```bash
+uv pip install airbyte-ai-hubspot
+```
+
+## Usage
+
+```python
+from airbyte_ai_hubspot import HubspotConnector, HubspotAuthConfig
+
+connector = HubspotConnector(
+ auth_config=HubspotAuthConfig(
+ client_id="...",
+ client_secret="...",
+ refresh_token="...",
+ access_token="..."
+ )
+)
+result = connector.contacts.list()
+```
+
+## Documentation
+
+| Entity | Actions |
+|--------|---------|
+| Contacts | [List](./REFERENCE.md#contacts-list), [Get](./REFERENCE.md#contacts-get), [Search](./REFERENCE.md#contacts-search) |
+| Companies | [List](./REFERENCE.md#companies-list), [Get](./REFERENCE.md#companies-get), [Search](./REFERENCE.md#companies-search) |
+| Deals | [List](./REFERENCE.md#deals-list), [Get](./REFERENCE.md#deals-get), [Search](./REFERENCE.md#deals-search) |
+| Tickets | [List](./REFERENCE.md#tickets-list), [Get](./REFERENCE.md#tickets-get), [Search](./REFERENCE.md#tickets-search) |
+| Schemas | [List](./REFERENCE.md#schemas-list), [Get](./REFERENCE.md#schemas-get) |
+| Objects | [List](./REFERENCE.md#objects-list), [Get](./REFERENCE.md#objects-get) |
+
+
+For detailed documentation on available actions and parameters, see [REFERENCE.md](./REFERENCE.md).
+
+For the service's official API docs, see [Hubspot API Reference](https://developers.hubspot.com/docs/api/crm/understanding-the-crm).
+
+## Version Information
+
+**Package Version:** 0.15.11
+
+**Connector Version:** 0.1.2
+
+**Generated with connector-sdk:** 1ab72bd8e7249872a4cf66327dd1a0bf68905acb
\ No newline at end of file
diff --git a/docs/ai-agents/connectors/hubspot/REFERENCE.md b/docs/ai-agents/connectors/hubspot/REFERENCE.md
new file mode 100644
index 00000000000..9c8874292f2
--- /dev/null
+++ b/docs/ai-agents/connectors/hubspot/REFERENCE.md
@@ -0,0 +1,1114 @@
+# Hubspot
+
+## Supported Entities and Actions
+
+| Entity | Actions |
+|--------|---------|
+| Contacts | [List](#contacts-list), [Get](#contacts-get), [Search](#contacts-search) |
+| Companies | [List](#companies-list), [Get](#companies-get), [Search](#companies-search) |
+| Deals | [List](#deals-list), [Get](#deals-get), [Search](#deals-search) |
+| Tickets | [List](#tickets-list), [Get](#tickets-get), [Search](#tickets-search) |
+| Schemas | [List](#schemas-list), [Get](#schemas-get) |
+| Objects | [List](#objects-list), [Get](#objects-get) |
+
+### Contacts
+
+#### Contacts List
+
+Returns a paginated list of contacts
+
+**Python SDK**
+
+```python
+hubspot.contacts.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "contacts",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | The maximum number of results to display per page. |
+| `after` | `string` | No | The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
+| `associations` | `string` | No | A comma separated list of associated object types to include in the response. Valid values are contacts, deals, tickets, and custom object type IDs or fully qualified names (e.g., "p12345_cars"). |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of companies that can be read by a single request. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_cursor` | `string` | |
+| `next_link` | `string` | |
+
+
+
+#### Contacts Get
+
+Get a single contact by ID
+
+**Python SDK**
+
+```python
+hubspot.contacts.get(
+ contact_id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "contacts",
+ "action": "get",
+ "params": {
+ "contactId": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `contactId` | `string` | Yes | Contact ID |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `associations` | `string` | No | A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
+| `idProperty` | `string` | No | The name of a property whose values are unique for this object. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+
+
+#### Contacts Search
+
+Search for contacts by filtering on properties, searching through associations, and sorting results.
+
+**Python SDK**
+
+```python
+hubspot.contacts.search()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "contacts",
+ "action": "search"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filterGroups` | `array` | No | Up to 6 groups of filters defining additional query criteria. |
+| `filterGroups.filters` | `array` | No | |
+| `filterGroups.filters.operator` | `"BETWEEN" \| "CONTAINS_TOKEN" \| "EQ" \| "GT" \| "GTE" \| "HAS_PROPERTY" \| "IN" \| "LT" \| "LTE" \| "NEQ" \| "NOT_CONTAINS_TOKEN" \| "NOT_HAS_PROPERTY" \| "NOT_IN"` | No | |
+| `filterGroups.filters.propertyName` | `string` | No | The name of the property to apply the filter on. |
+| `filterGroups.filters.value` | `string` | No | The value to match against the property. |
+| `filterGroups.filters.values` | `array` | No | The values to match against the property. |
+| `properties` | `array` | No | A list of property names to include in the response. |
+| `limit` | `integer` | No | Maximum number of results to return |
+| `after` | `string` | No | A paging cursor token for retrieving subsequent pages. |
+| `sorts` | `array` | No | Sort criteria |
+| `sorts.propertyName` | `string` | No | |
+| `sorts.direction` | `"ASCENDING" \| "DESCENDING"` | No | |
+| `query` | `string` | No | The search query string, up to 3000 characters. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `total` | `integer` | |
+| `next_cursor` | `string` | |
+| `next_link` | `string` | |
+
+
+
+### Companies
+
+#### Companies List
+
+Retrieve all companies, using query parameters to control the information that gets returned.
+
+**Python SDK**
+
+```python
+hubspot.companies.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "companies",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | The maximum number of results to display per page. |
+| `after` | `string` | No | The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
+| `associations` | `string` | No | A comma separated list of associated object types to include in the response. Valid values are contacts, deals, tickets, and custom object type IDs or fully qualified names (e.g., "p12345_cars"). |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of companies that can be read by a single request. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_cursor` | `string` | |
+| `next_link` | `string` | |
+
+
+
+#### Companies Get
+
+Get a single company by ID
+
+**Python SDK**
+
+```python
+hubspot.companies.get(
+ company_id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "companies",
+ "action": "get",
+ "params": {
+ "companyId": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `companyId` | `string` | Yes | Company ID |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `associations` | `string` | No | A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
+| `idProperty` | `string` | No | The name of a property whose values are unique for this object. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+
+
+#### Companies Search
+
+Search for companies by filtering on properties, searching through associations, and sorting results.
+
+**Python SDK**
+
+```python
+hubspot.companies.search()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "companies",
+ "action": "search"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `filterGroups` | `array` | No | Up to 6 groups of filters defining additional query criteria. |
+| `filterGroups.filters` | `array` | No | |
+| `filterGroups.filters.operator` | `"BETWEEN" \| "CONTAINS_TOKEN" \| "EQ" \| "GT" \| "GTE" \| "HAS_PROPERTY" \| "IN" \| "LT" \| "LTE" \| "NEQ" \| "NOT_CONTAINS_TOKEN" \| "NOT_HAS_PROPERTY" \| "NOT_IN"` | No | |
+| `filterGroups.filters.propertyName` | `string` | No | The name of the property to apply the filter on. |
+| `filterGroups.filters.value` | `string` | No | The value to match against the property. |
+| `filterGroups.filters.values` | `array` | No | The values to match against the property. |
+| `properties` | `array` | No | A list of property names to include in the response. |
+| `limit` | `integer` | No | Maximum number of results to return |
+| `after` | `string` | No | A paging cursor token for retrieving subsequent pages. |
+| `sorts` | `array` | No | Sort criteria |
+| `sorts.propertyName` | `string` | No | |
+| `sorts.direction` | `"ASCENDING" \| "DESCENDING"` | No | |
+| `query` | `string` | No | The search query string, up to 3000 characters. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `total` | `integer` | |
+| `next_cursor` | `string` | |
+| `next_link` | `string` | |
+
+
+
+### Deals
+
+#### Deals List
+
+Returns a paginated list of deals
+
+**Python SDK**
+
+```python
+hubspot.deals.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "deals",
+ "action": "list"
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `limit` | `integer` | No | The maximum number of results to display per page. |
+| `after` | `string` | No | The paging cursor token of the last successfully read resource will be returned as the paging.next.after JSON property of a paged response containing more results. |
+| `associations` | `string` | No | A comma separated list of associated object types to include in the response. Valid values are contacts, deals, tickets, and custom object type IDs or fully qualified names (e.g., "p12345_cars"). |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. Usage of this parameter will reduce the maximum number of companies that can be read by a single request. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+Response Schema
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `id` | `string` | |
+| `properties` | `object` | |
+| `createdAt` | `string` | |
+| `updatedAt` | `string` | |
+| `archived` | `boolean` | |
+| `archivedAt` | `string \| null` | |
+| `propertiesWithHistory` | `object \| null` | |
+| `associations` | `object \| null` | |
+| `objectWriteTraceId` | `string \| null` | |
+| `url` | `string \| null` | |
+
+
+**Meta**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `next_cursor` | `string` | |
+| `next_link` | `string` | |
+
+
+
+#### Deals Get
+
+Get a single deal by ID
+
+**Python SDK**
+
+```python
+hubspot.deals.get(
+ deal_id=""
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+ "entity": "deals",
+ "action": "get",
+ "params": {
+ "dealId": ""
+ }
+}'
+```
+
+
+**Params**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `dealId` | `string` | Yes | Deal ID |
+| `properties` | `string` | No | A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `propertiesWithHistory` | `string` | No | A comma separated list of the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested object(s), they will be ignored. |
+| `associations` | `string` | No | A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored. |
+| `idProperty` | `string` | No | The name of a property whose values are unique for this object. |
+| `archived` | `boolean` | No | Whether to return only results that have been archived. |
+
+
+
+