api-gateway

Files (200)

• SKILL.md
• _meta.json
• prompt_context.md
• README.md · references/active-campaign/
• README.md · references/acuity-scheduling/
• README.md · references/airtable/
• README.md · references/apify/
• README.md · references/apollo/
• README.md · references/asana/
• README.md · references/attio/
• README.md · references/basecamp/
• README.md · references/baserow/
• README.md · references/beehiiv/
• README.md · references/box/
• README.md · references/brave-search/
• README.md · references/brevo/
• README.md · references/buffer/
• README.md · references/cal-com/
• README.md · references/calendly/
• README.md · references/callrail/
• README.md · references/chargebee/
• README.md · references/clickfunnels/
• README.md · references/clicksend/
• README.md · references/clickup/
• README.md · references/clio/
• README.md · references/clockify/
• README.md · references/coda/
• README.md · references/cognito-forms/
• README.md · references/companycam/
• README.md · references/confluence/
• README.md · references/constant-contact/
• README.md · references/dropbox-business/
• README.md · references/dropbox/
• README.md · references/elevenlabs/
• README.md · references/eventbrite/
• README.md · references/exa/
• README.md · references/facebook-page/
• README.md · references/fal-ai/
• README.md · references/fathom/
• README.md · references/firebase/
• README.md · references/firecrawl/
• README.md · references/fireflies/
• README.md · references/front/
• README.md · references/getresponse/
• README.md · references/github/
• README.md · references/google-ads/
• README.md · references/google-analytics-admin/
• README.md · references/google-analytics-data/
• README.md · references/google-bigquery/
• README.md · references/google-calendar/
• README.md · references/google-classroom/
• README.md · references/google-contacts/
• README.md · references/google-docs/
• README.md · references/google-drive/
• README.md · references/google-forms/
• README.md · references/google-mail/
• README.md · references/google-meet/
• README.md · references/google-merchant/
• README.md · references/google-play/
• README.md · references/google-search-console/
• …and 140 more

SKILL.md (first lines)

# API Gateway

Managed API routing for third-party services, provided by [Maton](https://maton.ai). Use this only for a user-requested app, account, and task.

## Quick Start

```bash
# List Slack channels (read-only)
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```


## Routing

Use `https://api.maton.ai/` with the app-prefixed routes documented in the examples below or in the matching reference file.

Read-only route examples:

```text
https://api.maton.ai/slack/api/conversations.list?types=public_channel&limit=10
https://api.maton.ai/google-mail/gmail/v1/users/me/messages
```

The first path segment is the app identifier listed in Supported Services. For Gmail, use `/google-mail/gmail/v1/users/me/messages`.

## Authentication

Use `MATON_API_KEY` from the environment when constructing the request's Authorization header, as shown in the examples. Never print or copy the key.

**IMPORTANT:** Treat `MATON_API_KEY` as a secret. Do not log it, paste it into prompts, or expose it in shared files or command output. Authorize only the services and scopes needed for the current task, revoke unused connections, and rotate the key if exposed.

**Environment Variable:** You can set your API key as the `MATON_API_KEY` environment variable:

```bash
export MATON_API_KEY="YOUR_API_KEY"
```

## Getting Your API Key

1. Sign in or create an account at [maton.ai](https://maton.ai)
2. Go to [maton.ai/settings](https://maton.ai/settings)
3. Click the copy button on the right side of API Key section to copy it

## Connection Management

Connection management uses a separate base URL: `https://api.maton.ai`

### List Connections

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Query Parameters (optional):**
- `app` - Filter by service name (e.g., `slack`, `hubspot`, `salesforce`)
- `status` - Filter by connection status (`ACTIVE`, `PENDING`, `FAILED`)

**Response:**
```json
{
  "connections": [
    {
      "connection_id": "{connection_id}",
      "status": "ACTIVE",
      "creation_time": "2025-12-08T07:20:53.488460Z",
      "last_updated_time": "2026-01-31T20:03:32.593153Z",
      "url": "https://connect.maton.ai/?session_token=5e9...",
      "app": "slack",
      "method": "OAUTH2",
      "metadata": {}
    }
  ]
}
```

### Create Connection

```bash
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'slack'}).encode()
req = urllib.request.Request('https://api.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Request Body:**
- `app` (required) - Service name (e.g., `slack`, `notion`)
- `method` (optional) - Connection method (`API_KEY`, `BASIC`, `OAUTH1`, `OAUTH2`, `MCP`)

### Get Connection

```bash
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://api.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
```

**Response:**
```json
{
  "connection": {
    "connection_id": "{connection_id}",
    "status": "ACTIVE",

From badmarsh/librefang, MIT.

More from badmarsh/librefang