Skip to content

LeoYeAI/agent-master-skills / skills/api-gateway

api-gateway

Verified

Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to interact with external services. Security: The MATON_API_KEY authenticates with Maton.ai but grants NO access to third-party services by itself. Each service requires explicit OAuth authorization by the user through Maton's connect flow. Access is strictly scoped to connections the user has authorized. Provided by Maton (https://maton.ai).

FileKindSize
LICENSE.txtmarkdown1.0 KB
SKILL.mdskill md31.4 KB
references/active-campaign/README.mdmarkdown3.2 KB
references/acuity-scheduling/README.mdmarkdown3.0 KB
references/airtable/README.mdmarkdown3.0 KB
references/apollo/README.mdmarkdown4.0 KB
references/asana/README.mdmarkdown2.7 KB
references/attio/README.mdmarkdown4.8 KB
references/basecamp/README.mdmarkdown2.8 KB
references/baserow/README.mdmarkdown3.7 KB
references/beehiiv/README.mdmarkdown2.6 KB
references/box/README.mdmarkdown2.8 KB
references/brave-search/README.mdmarkdown2.8 KB
references/brevo/README.mdmarkdown3.7 KB
references/cal-com/README.mdmarkdown3.4 KB
references/calendly/README.mdmarkdown2.6 KB
references/callrail/README.mdmarkdown3.1 KB
references/chargebee/README.mdmarkdown5.5 KB
references/clickfunnels/README.mdmarkdown5.3 KB
references/clicksend/README.mdmarkdown2.3 KB
references/clickup/README.mdmarkdown2.9 KB
references/clio/README.mdmarkdown6.1 KB
references/clockify/README.mdmarkdown3.7 KB
references/coda/README.mdmarkdown3.6 KB
references/cognito-forms/README.mdmarkdown2.4 KB
references/companycam/README.mdmarkdown3.6 KB
references/confluence/README.mdmarkdown4.6 KB
references/constant-contact/README.mdmarkdown2.5 KB
references/dropbox-business/README.mdmarkdown11.7 KB
references/dropbox/README.mdmarkdown3.1 KB
references/elevenlabs/README.mdmarkdown1.8 KB
references/eventbrite/README.mdmarkdown4.2 KB
references/exa/README.mdmarkdown4.0 KB
references/fathom/README.mdmarkdown1.9 KB
references/firebase/README.mdmarkdown3.1 KB
references/firecrawl/README.mdmarkdown3.5 KB
references/fireflies/README.mdmarkdown1.8 KB
references/getresponse/README.mdmarkdown2.8 KB
references/github/README.mdmarkdown2.5 KB
references/google-ads/README.mdmarkdown3.9 KB
references/google-analytics-admin/README.mdmarkdown5.7 KB
references/google-analytics-data/README.mdmarkdown4.2 KB
references/google-bigquery/README.mdmarkdown3.9 KB
references/google-calendar/README.mdmarkdown3.7 KB
references/google-classroom/README.mdmarkdown2.6 KB
references/google-contacts/README.mdmarkdown3.3 KB
references/google-docs/README.mdmarkdown2.9 KB
references/google-drive/README.mdmarkdown5.1 KB
references/google-forms/README.mdmarkdown4.1 KB
references/google-mail/README.mdmarkdown3.6 KB
references/google-meet/README.mdmarkdown2.7 KB
references/google-merchant/README.mdmarkdown5.0 KB
references/google-play/README.mdmarkdown3.8 KB
references/google-search-console/README.mdmarkdown3.8 KB
references/google-sheets/README.mdmarkdown6.0 KB
references/google-slides/README.mdmarkdown4.5 KB
references/google-tasks/README.mdmarkdown3.0 KB
references/google-workspace-admin/README.mdmarkdown4.6 KB
references/grafana/README.mdmarkdown2.8 KB
references/granola-mcp/README.mdmarkdown5.7 KB
references/granola-mcp/schemas/get_meeting_transcript.jsonconfig819 B
references/granola-mcp/schemas/get_meetings.jsonconfig893 B
references/granola-mcp/schemas/list_meetings.jsonconfig1.5 KB
references/granola-mcp/schemas/query_granola_meetings.jsonconfig1.6 KB
references/gumroad/README.mdmarkdown3.3 KB
references/hubspot/README.mdmarkdown9.8 KB
references/instantly/README.mdmarkdown3.0 KB
references/jira/README.mdmarkdown4.5 KB
references/jobber/README.mdmarkdown3.6 KB
references/jotform/README.mdmarkdown3.6 KB
references/kaggle/README.mdmarkdown2.5 KB
references/keap/README.mdmarkdown3.1 KB
references/kibana/README.mdmarkdown2.7 KB
references/kit/README.mdmarkdown3.3 KB
references/klaviyo/README.mdmarkdown3.8 KB
references/lemlist/README.mdmarkdown2.4 KB
references/linear/README.mdmarkdown4.3 KB
references/linkedin/README.mdmarkdown5.4 KB
references/mailchimp/README.mdmarkdown4.1 KB
references/mailerlite/README.mdmarkdown4.0 KB
references/mailgun/README.mdmarkdown4.7 KB
references/manus/README.mdmarkdown2.4 KB
references/manychat/README.mdmarkdown3.6 KB
references/microsoft-excel/README.mdmarkdown3.8 KB
references/microsoft-teams/README.mdmarkdown5.9 KB
references/microsoft-to-do/README.mdmarkdown3.6 KB
references/monday/README.mdmarkdown4.4 KB
references/motion/README.mdmarkdown2.7 KB
references/netlify/README.mdmarkdown3.6 KB
references/notion-mcp/README.mdmarkdown12.8 KB
references/notion-mcp/schemas/notion-create-comment.jsonconfig17.6 KB
references/notion-mcp/schemas/notion-create-database.jsonconfig3.4 KB
references/notion-mcp/schemas/notion-create-pages.jsonconfig8.7 KB
references/notion-mcp/schemas/notion-duplicate-page.jsonconfig927 B
references/notion-mcp/schemas/notion-fetch.jsonconfig2.1 KB
references/notion-mcp/schemas/notion-get-comments.jsonconfig1.6 KB
references/notion-mcp/schemas/notion-get-teams.jsonconfig863 B
references/notion-mcp/schemas/notion-get-users.jsonconfig1.7 KB
references/notion-mcp/schemas/notion-move-pages.jsonconfig3.2 KB
references/notion-mcp/schemas/notion-search.jsonconfig5.4 KB
references/notion-mcp/schemas/notion-update-data-source.jsonconfig3.5 KB
references/notion-mcp/schemas/notion-update-page.jsonconfig8.4 KB
references/notion/README.mdmarkdown7.9 KB
references/one-drive/README.mdmarkdown2.3 KB
references/outlook/README.mdmarkdown4.1 KB
references/pdf-co/README.mdmarkdown5.0 KB
references/pipedrive/README.mdmarkdown3.0 KB
references/podio/README.mdmarkdown3.2 KB
references/posthog/README.mdmarkdown3.3 KB
references/quickbooks/README.mdmarkdown11.1 KB
references/quo/README.mdmarkdown2.9 KB
references/reducto/README.mdmarkdown2.4 KB
references/salesforce/README.mdmarkdown6.6 KB
references/sendgrid/README.mdmarkdown2.9 KB
references/sentry/README.mdmarkdown3.1 KB
references/sharepoint/README.mdmarkdown5.2 KB
references/signnow/README.mdmarkdown1.8 KB
references/slack/README.mdmarkdown7.6 KB
references/snapchat/README.mdmarkdown2.7 KB
references/squarespace/README.mdmarkdown8.1 KB
references/squareup/README.mdmarkdown9.8 KB
references/stripe/README.mdmarkdown7.4 KB
references/sunsama-mcp/README.mdmarkdown4.4 KB
references/sunsama-mcp/schemas/accept_meeting_invite.jsonconfig299 B
references/sunsama-mcp/schemas/add_subtasks_to_task.jsonconfig663 B
references/sunsama-mcp/schemas/add_task_to_channel.jsonconfig386 B
references/sunsama-mcp/schemas/align_task_with_objective.jsonconfig414 B
references/sunsama-mcp/schemas/append_task_notes.jsonconfig379 B
references/sunsama-mcp/schemas/change_backlog_folder.jsonconfig399 B
references/sunsama-mcp/schemas/create_braindump_task.jsonconfig616 B
references/sunsama-mcp/schemas/create_calendar_event.jsonconfig421 B
references/sunsama-mcp/schemas/create_channel.jsonconfig301 B
references/sunsama-mcp/schemas/create_follow_up_task_from_email.jsonconfig575 B
references/sunsama-mcp/schemas/create_task.jsonconfig580 B
references/sunsama-mcp/schemas/create_weekly_objective.jsonconfig440 B
references/sunsama-mcp/schemas/decline_meeting_invite.jsonconfig301 B
references/sunsama-mcp/schemas/delete_all_incomplete_recurring_task_instances.jsonconfig337 B
references/sunsama-mcp/schemas/delete_calendar_event.jsonconfig290 B
references/sunsama-mcp/schemas/delete_email_thread.jsonconfig540 B
references/sunsama-mcp/schemas/delete_task.jsonconfig268 B
references/sunsama-mcp/schemas/edit_subtask_title.jsonconfig526 B
references/sunsama-mcp/schemas/edit_task_recurrence_rule.jsonconfig448 B
references/sunsama-mcp/schemas/edit_task_time_estimate.jsonconfig418 B
references/sunsama-mcp/schemas/edit_task_title.jsonconfig375 B
references/sunsama-mcp/schemas/get_archived_tasks.jsonconfig162 B
references/sunsama-mcp/schemas/get_backlog_tasks.jsonconfig171 B
references/sunsama-mcp/schemas/get_task_time_estimate.jsonconfig309 B
references/sunsama-mcp/schemas/import_task_from_calendar_event.jsonconfig312 B
references/sunsama-mcp/schemas/list_email_threads.jsonconfig310 B
references/sunsama-mcp/schemas/log_user_feedback.jsonconfig277 B
references/sunsama-mcp/schemas/mark_email_thread_as_read.jsonconfig552 B
references/sunsama-mcp/schemas/mark_subtask_as_completed.jsonconfig409 B
references/sunsama-mcp/schemas/mark_subtask_as_incomplete.jsonconfig411 B
references/sunsama-mcp/schemas/mark_task_as_completed.jsonconfig441 B
references/sunsama-mcp/schemas/mark_task_as_incomplete.jsonconfig282 B
references/sunsama-mcp/schemas/move_calendar_event.jsonconfig536 B
references/sunsama-mcp/schemas/move_task_from_backlog.jsonconfig432 B
references/sunsama-mcp/schemas/move_task_to_backlog.jsonconfig288 B
references/sunsama-mcp/schemas/move_task_to_day.jsonconfig428 B
references/sunsama-mcp/schemas/reorder_tasks.jsonconfig484 B
references/sunsama-mcp/schemas/reposition_task_in_backlog.jsonconfig622 B
references/sunsama-mcp/schemas/restore_task.jsonconfig279 B
references/sunsama-mcp/schemas/schedule_next_call.jsonconfig569 B
references/sunsama-mcp/schemas/search_tasks.jsonconfig292 B
references/sunsama-mcp/schemas/set_calendar_event_allow_task_projections.jsonconfig518 B
references/sunsama-mcp/schemas/set_shutdown_time.jsonconfig508 B
references/sunsama-mcp/schemas/start_task_timer.jsonconfig276 B
references/sunsama-mcp/schemas/stop_task_timer.jsonconfig274 B
references/sunsama-mcp/schemas/timebox_a_task_to_calendar.jsonconfig555 B
references/sunsama-mcp/schemas/toggle_auto_import_events.jsonconfig311 B
references/sunsama-mcp/schemas/unarchive_task.jsonconfig453 B
references/sunsama-mcp/schemas/update_all_incomplete_recurring_task_instances.jsonconfig337 B
references/sunsama-mcp/schemas/update_calendar_preferences.jsonconfig319 B
references/sunsama-mcp/schemas/update_import_event_filters.jsonconfig387 B
references/systeme/README.mdmarkdown3.4 KB
references/tally/README.mdmarkdown3.0 KB
references/tavily/README.mdmarkdown2.8 KB
references/telegram/README.mdmarkdown3.3 KB
references/ticktick/README.mdmarkdown2.5 KB
references/todoist/README.mdmarkdown2.7 KB
references/toggl-track/README.mdmarkdown3.7 KB
references/trello/README.mdmarkdown3.5 KB
references/twilio/README.mdmarkdown3.7 KB
references/typeform/README.mdmarkdown5.0 KB
references/unbounce/README.mdmarkdown2.9 KB
references/vimeo/README.mdmarkdown2.2 KB
references/whatsapp-business/README.mdmarkdown4.9 KB
references/woocommerce/README.mdmarkdown6.9 KB
references/wordpress/README.mdmarkdown3.2 KB
references/wrike/README.mdmarkdown3.6 KB
references/xero/README.mdmarkdown5.9 KB
references/youtube/README.mdmarkdown4.0 KB
references/zoho-bigin/README.mdmarkdown2.3 KB
references/zoho-bookings/README.mdmarkdown3.1 KB
references/zoho-books/README.mdmarkdown3.1 KB
references/zoho-calendar/README.mdmarkdown2.8 KB
references/zoho-crm/README.mdmarkdown4.0 KB
references/zoho-inventory/README.mdmarkdown5.6 KB
references/zoho-mail/README.mdmarkdown3.9 KB
references/zoho-people/README.mdmarkdown3.5 KB

references/notion/README.md

View on GitHub
# Notion Routing Reference

**App name:** `notion`
**Base URL proxied:** `api.notion.com`

## Required Headers

All Notion API requests require:
```
Notion-Version: 2025-09-03
```

## API Path Pattern

```
/notion/v1/{endpoint}
```

## Key Concept: Databases vs Data Sources

In API version 2025-09-03, databases and data sources are separate concepts:

| Concept | Description | Use For |
|---------|-------------|---------|
| **Database** | Container that can hold multiple data sources | Creating databases, getting data_source IDs |
| **Data Source** | Schema and data within a database | Querying, updating schema, updating properties |

Most existing databases have one data source. Use `GET /databases/{id}` to get the `data_source_id`, then use `/data_sources/` endpoints for all operations.

## Common Endpoints

### Search

Search for pages:
```bash
POST /notion/v1/search
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "query": "meeting notes",
  "filter": {"property": "object", "value": "page"}
}
```

Search for data sources:
```bash
POST /notion/v1/search
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "filter": {"property": "object", "value": "data_source"}
}
```

With pagination:
```bash
POST /notion/v1/search
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "page_size": 10,
  "start_cursor": "CURSOR_FROM_PREVIOUS_RESPONSE"
}
```

### Data Sources

Use data source endpoints for querying, getting schema, and updates.

#### Get Data Source
```bash
GET /notion/v1/data_sources/{dataSourceId}
Notion-Version: 2025-09-03
```

Returns full schema with `properties` field.

#### Query Data Source
```bash
POST /notion/v1/data_sources/{dataSourceId}/query
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "filter": {
    "property": "Status",
    "select": {"equals": "Active"}
  },
  "sorts": [
    {"property": "Created", "direction": "descending"}
  ],
  "page_size": 100
}
```

#### Update Data Source (title, schema, properties)
```bash
PATCH /notion/v1/data_sources/{dataSourceId}
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "title": [{"type": "text", "text": {"content": "Updated Title"}}],
  "properties": {
    "NewColumn": {"rich_text": {}}
  }
}
```

### Databases

Database endpoints are only needed for **creating** databases and **discovering** data source IDs.

#### Get Database (to find data_source_id)
```bash
GET /notion/v1/databases/{databaseId}
Notion-Version: 2025-09-03
```

Response includes `data_sources` array:
```json
{
  "id": "database-id",
  "object": "database",
  "data_sources": [{"id": "data-source-id", "name": "Database Name"}]
}
```

**Note:** This endpoint returns `properties: null`. Use `GET /data_sources/{id}` to get the schema.

#### Create Database
```bash
POST /notion/v1/databases
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "parent": {"type": "page_id", "page_id": "PARENT_PAGE_ID"},
  "title": [{"type": "text", "text": {"content": "New Database"}}],
  "properties": {
    "Name": {"title": {}},
    "Status": {"select": {"options": [{"name": "Active"}, {"name": "Done"}]}}
  }
}
```

**Important:** Cannot create databases via `/data_sources` endpoint.

### Pages

#### Get Page
```bash
GET /notion/v1/pages/{pageId}
Notion-Version: 2025-09-03
```

#### Create Page in Data Source
Use `data_source_id` (not `database_id`) as parent:
```bash
POST /notion/v1/pages
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "parent": {"data_source_id": "DATA_SOURCE_ID"},
  "properties": {
    "Name": {"title": [{"text": {"content": "New Page"}}]},
    "Status": {"select": {"name": "Active"}}
  }
}
```

#### Create Child Page (under another page)
```bash
POST /notion/v1/pages
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "parent": {"page_id": "PARENT_PAGE_ID"},
  "properties": {
    "title": {"title": [{"text": {"content": "Child Page"}}]}
  }
}
```

#### Update Page Properties
```bash
PATCH /notion/v1/pages/{pageId}
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "properties": {
    "Status": {"select": {"name": "Done"}}
  }
}
```

#### Archive Page
```bash
PATCH /notion/v1/pages/{pageId}
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "archived": true
}
```

### Blocks

#### Get Block
```bash
GET /notion/v1/blocks/{blockId}
Notion-Version: 2025-09-03
```

#### Get Block Children
```bash
GET /notion/v1/blocks/{blockId}/children
Notion-Version: 2025-09-03
```

#### Append Block Children
```bash
PATCH /notion/v1/blocks/{blockId}/children
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "children": [
    {
      "object": "block",
      "type": "paragraph",
      "paragraph": {
        "rich_text": [{"type": "text", "text": {"content": "New paragraph"}}]
      }
    },
    {
      "object": "block",
      "type": "heading_2",
      "heading_2": {
        "rich_text": [{"type": "text", "text": {"content": "Heading"}}]
      }
    }
  ]
}
```

#### Update Block
```bash
PATCH /notion/v1/blocks/{blockId}
Content-Type: application/json
Notion-Version: 2025-09-03

{
  "paragraph": {
    "rich_text": [{"text": {"content": "Updated text"}}]
  }
}
```

#### Delete Block
```bash
DELETE /notion/v1/blocks/{blockId}
Notion-Version: 2025-09-03
```

### Users

#### List Users
```bash
GET /notion/v1/users
Notion-Version: 2025-09-03
```

#### Get User by ID
```bash
GET /notion/v1/users/{userId}
Notion-Version: 2025-09-03
```

#### Get Current User (Bot)
```bash
GET /notion/v1/users/me
Notion-Version: 2025-09-03
```

## Filter Operators

- `equals`, `does_not_equal`
- `contains`, `does_not_contain`
- `starts_with`, `ends_with`
- `is_empty`, `is_not_empty`
- `greater_than`, `less_than`, `greater_than_or_equal_to`, `less_than_or_equal_to`

## Block Types

Common block types for appending:
- `paragraph` - Text paragraph
- `heading_1`, `heading_2`, `heading_3` - Headings
- `bulleted_list_item`, `numbered_list_item` - List items
- `to_do` - Checkbox item
- `code` - Code block
- `quote` - Quote block
- `divider` - Horizontal divider

## Migration from Older API Versions

| Old (2022-06-28) | New (2025-09-03) |
|------------------|------------------|
| `POST /databases/{id}/query` | `POST /data_sources/{id}/query` |
| `GET /databases/{id}` for schema | `GET /data_sources/{id}` for schema |
| `PATCH /databases/{id}` for schema | `PATCH /data_sources/{id}` for schema |
| Parent: `{"database_id": "..."}` | Parent: `{"data_source_id": "..."}` |
| Search filter: `"database"` | Search filter: `"data_source"` |

## Notes

- Use `GET /databases/{id}` to discover `data_source_id`, then use `/data_sources/` for all operations
- Creating databases still requires `POST /databases` endpoint
- Parent objects for create database require `type` field: `{"type": "page_id", "page_id": "..."}`
- All IDs are UUIDs (with or without hyphens)
- Delete blocks returns the block with `archived: true`

## Resources

- [API Introduction](https://developers.notion.com/reference/intro)
- [Search](https://developers.notion.com/reference/post-search.md)
- [Query Database](https://developers.notion.com/reference/post-database-query.md)
- [Get Database](https://developers.notion.com/reference/retrieve-a-database.md)
- [Create Database](https://developers.notion.com/reference/create-a-database.md)
- [Get Page](https://developers.notion.com/reference/retrieve-a-page.md)
- [Create Page](https://developers.notion.com/reference/post-page.md)
- [Update Page](https://developers.notion.com/reference/patch-page.md)
- [Get Block Children](https://developers.notion.com/reference/get-block-children.md)
- [Append Block Children](https://developers.notion.com/reference/patch-block-children.md)
- [List Users](https://developers.notion.com/reference/get-users.md)
- [Filter Reference](https://developers.notion.com/reference/post-database-query-filter.md)
- [LLM Reference](https://developers.notion.com/llms.txt)
- [Version Reference](https://developers.notion.com/guides/get-started/upgrade-guide-2025-09-03)
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall