@hasna/connectors 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -0
- package/bin/index.js +353 -3
- package/bin/mcp.js +1 -1
- package/connectors/connect-anthropic/AGENTS.md +22 -0
- package/connectors/connect-anthropic/CLAUDE.md +29 -0
- package/connectors/connect-anthropic/README.md +22 -3
- package/connectors/connect-anthropic/src/types/index.ts +46 -2
- package/connectors/connect-aws/CLAUDE.md +16 -0
- package/connectors/connect-brandsight/CLAUDE.md +5 -0
- package/connectors/connect-cloudflare/CLAUDE.md +21 -0
- package/connectors/connect-discord/CLAUDE.md +19 -0
- package/connectors/connect-docker/CLAUDE.md +8 -0
- package/connectors/connect-e2b/CLAUDE.md +21 -0
- package/connectors/connect-elevenlabs/CLAUDE.md +24 -0
- package/connectors/connect-exa/CLAUDE.md +35 -0
- package/connectors/connect-figma/CLAUDE.md +34 -0
- package/connectors/connect-firecrawl/CLAUDE.md +27 -0
- package/connectors/connect-github/CLAUDE.md +32 -2
- package/connectors/connect-gmail/CLAUDE.md +22 -0
- package/connectors/connect-google/CLAUDE.md +11 -0
- package/connectors/connect-googlecalendar/CLAUDE.md +9 -0
- package/connectors/connect-googlecloud/CLAUDE.md +12 -0
- package/connectors/connect-googlecontacts/CLAUDE.md +7 -0
- package/connectors/connect-googledocs/CLAUDE.md +7 -0
- package/connectors/connect-googledrive/CLAUDE.md +5 -0
- package/connectors/connect-googlegemini/CLAUDE.md +18 -0
- package/connectors/connect-googlegemini/src/types/index.ts +10 -3
- package/connectors/connect-googlemaps/CLAUDE.md +15 -0
- package/connectors/connect-googlesheets/CLAUDE.md +10 -0
- package/connectors/connect-googletasks/CLAUDE.md +6 -0
- package/connectors/connect-hedra/CLAUDE.md +15 -0
- package/connectors/connect-heygen/CLAUDE.md +14 -0
- package/connectors/connect-huggingface/CLAUDE.md +20 -0
- package/connectors/connect-icons8/CLAUDE.md +6 -0
- package/connectors/connect-maropost/CLAUDE.md +6 -0
- package/connectors/connect-mercury/CLAUDE.md +14 -0
- package/connectors/connect-meta/CLAUDE.md +16 -0
- package/connectors/connect-midjourney/CLAUDE.md +7 -0
- package/connectors/connect-mistral/CLAUDE.md +20 -0
- package/connectors/connect-mistral/src/types/index.ts +42 -7
- package/connectors/connect-mixpanel/CLAUDE.md +11 -0
- package/connectors/connect-notion/CLAUDE.md +30 -0
- package/connectors/connect-openai/AGENTS.md +15 -0
- package/connectors/connect-openai/CLAUDE.md +23 -0
- package/connectors/connect-openai/src/types/index.ts +36 -14
- package/connectors/connect-openweathermap/CLAUDE.md +8 -0
- package/connectors/connect-pandadoc/CLAUDE.md +18 -0
- package/connectors/connect-quo/CLAUDE.md +5 -0
- package/connectors/connect-reddit/CLAUDE.md +20 -0
- package/connectors/connect-reducto/CLAUDE.md +16 -0
- package/connectors/connect-resend/CLAUDE.md +21 -0
- package/connectors/connect-revolut/CLAUDE.md +17 -0
- package/connectors/connect-sedo/CLAUDE.md +6 -0
- package/connectors/connect-sentry/CLAUDE.md +11 -0
- package/connectors/connect-shadcn/CLAUDE.md +42 -0
- package/connectors/connect-shopify/CLAUDE.md +18 -0
- package/connectors/connect-snap/CLAUDE.md +6 -0
- package/connectors/connect-stabilityai/CLAUDE.md +13 -0
- package/connectors/connect-stripe/CLAUDE.md +19 -0
- package/connectors/connect-stripeatlas/CLAUDE.md +7 -0
- package/connectors/connect-substack/CLAUDE.md +6 -0
- package/connectors/connect-tiktok/CLAUDE.md +25 -0
- package/connectors/connect-tinker/CLAUDE.md +6 -0
- package/connectors/connect-twilio/CLAUDE.md +9 -0
- package/connectors/connect-uspto/CLAUDE.md +8 -0
- package/connectors/connect-webflow/CLAUDE.md +19 -0
- package/connectors/connect-wix/CLAUDE.md +20 -0
- package/connectors/connect-x/CLAUDE.md +15 -0
- package/connectors/connect-xads/CLAUDE.md +10 -0
- package/connectors/connect-xai/CLAUDE.md +15 -0
- package/connectors/connect-xai/src/types/index.ts +20 -4
- package/connectors/connect-youtube/CLAUDE.md +28 -0
- package/connectors/connect-zoom/CLAUDE.md +15 -0
- package/dist/lib/test-endpoints.d.ts +12 -0
- package/package.json +1 -1
|
@@ -47,6 +47,22 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Graph API Updates (2025-2026)
|
|
51
|
+
|
|
52
|
+
### Current Version: v24.0 (Oct 2025)
|
|
53
|
+
|
|
54
|
+
### Breaking Changes in v24.0
|
|
55
|
+
- **Advantage+ Shopping/App campaigns**: Cannot be created/updated via API from v24.0 (Feb 2025). Extends to ALL versions by May 19, 2026. Migrate to new Automation Unification workflow.
|
|
56
|
+
- **Customer file custom audiences**: Flagged audiences fail to update (effective Jan 6, 2026 for all versions)
|
|
57
|
+
- **Certificate Transparency**: All endpoints/webhooks removed (Oct 17, 2025)
|
|
58
|
+
- **Live Video API**: `overlay_url` field removed
|
|
59
|
+
- **Messenger lead ads**: Cannot create lead ads that generate leads in Messenger via API
|
|
60
|
+
|
|
61
|
+
### Upcoming Changes (by Jun 2026)
|
|
62
|
+
- **Page Viewer Metric**: Replaces legacy reach metric — consistent cross-platform measurement (Facebook + Instagram)
|
|
63
|
+
- **Retiring**: Post/Page Reach, Video Impressions, Story Impressions metrics
|
|
64
|
+
- **Webhook permissions**: Updates coming
|
|
65
|
+
|
|
50
66
|
## Authentication
|
|
51
67
|
|
|
52
68
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,13 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Status (2026) — Important
|
|
51
|
+
|
|
52
|
+
No official public API. The official API is only available to Enterprise subscribers.
|
|
53
|
+
- Official API: `https://api.midjourney.com/v2` with Bearer token (Enterprise only)
|
|
54
|
+
- Current model: **v8** (2026) — text rendering, video gen (10s/60fps), 3D export, `--cref`
|
|
55
|
+
- Unofficial third-party wrappers (Apiframe, TTAPI) available but may violate ToS
|
|
56
|
+
|
|
50
57
|
## Authentication
|
|
51
58
|
|
|
52
59
|
Bearer Token authentication. Credentials can be set via:
|
|
@@ -47,6 +47,26 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Models (2026)
|
|
51
|
+
|
|
52
|
+
| Model | Description |
|
|
53
|
+
|-------|-------------|
|
|
54
|
+
| `mistral-large-latest` | Large 3 (Dec 2025), top-tier |
|
|
55
|
+
| `mistral-medium-latest` | Medium 3.1 (Aug 2025), multimodal — **recommended default** |
|
|
56
|
+
| `magistral-medium-latest` | Magistral 1.2 (Sep 2025), reasoning + vision, 40K ctx |
|
|
57
|
+
| `codestral-latest` | Codestral 2508, code specialist, 256K context |
|
|
58
|
+
| `devstral-latest` | Devstral Medium, coding agents, multi-file editing |
|
|
59
|
+
| `ministral-8b-latest` | Edge model, fast and cheap |
|
|
60
|
+
| `ministral-3b-latest` | Fastest edge model |
|
|
61
|
+
|
|
62
|
+
New capabilities (2025-2026):
|
|
63
|
+
- **OCR / Document AI**: `mistral-ocr-2512` via `POST /v1/ocr`
|
|
64
|
+
- **Audio transcription**: `voxtral-mini-2602` via `POST /v1/audio/transcriptions` (with diarize, context biasing)
|
|
65
|
+
- **Reasoning**: Magistral series with extended thinking
|
|
66
|
+
- **Coding agents**: Devstral for multi-file codebase exploration
|
|
67
|
+
|
|
68
|
+
Default: `mistral-medium-latest`
|
|
69
|
+
|
|
50
70
|
## Authentication
|
|
51
71
|
|
|
52
72
|
Bearer Token authentication. Credentials can be set via:
|
|
@@ -5,26 +5,61 @@ export interface MistralConfig {
|
|
|
5
5
|
baseUrl?: string;
|
|
6
6
|
}
|
|
7
7
|
|
|
8
|
-
// Models
|
|
8
|
+
// Models (2026)
|
|
9
9
|
export type MistralModel =
|
|
10
|
-
|
|
10
|
+
// Latest aliases (always point to newest)
|
|
11
|
+
| 'mistral-large-latest' // → mistral-large-2512
|
|
12
|
+
| 'mistral-medium-latest' // → mistral-medium-2508
|
|
11
13
|
| 'mistral-small-latest'
|
|
12
|
-
| 'codestral-latest'
|
|
14
|
+
| 'codestral-latest' // → codestral-2508
|
|
15
|
+
| 'magistral-medium-latest' // → magistral-medium-2509
|
|
13
16
|
| 'ministral-8b-latest'
|
|
14
17
|
| 'ministral-3b-latest'
|
|
15
|
-
| '
|
|
16
|
-
| '
|
|
18
|
+
| 'pixtral-large-latest'
|
|
19
|
+
| 'devstral-latest'
|
|
20
|
+
// Pinned versions (2025-2026)
|
|
21
|
+
| 'mistral-large-2512' // Mistral Large 3 (Dec 2025)
|
|
22
|
+
| 'mistral-medium-2508' // Mistral Medium 3.1 (Aug 2025)
|
|
23
|
+
| 'mistral-medium-2505' // Mistral Medium 3 (May 2025)
|
|
24
|
+
| 'magistral-medium-2509' // Magistral Medium 1.2 (Sep 2025, reasoning)
|
|
25
|
+
| 'magistral-medium-2507' // Magistral Medium 1.1
|
|
26
|
+
| 'magistral-medium-2506' // Magistral Medium 1.0
|
|
27
|
+
| 'magistral-small-2509' // Magistral Small 1.2
|
|
28
|
+
| 'codestral-2508' // Codestral (Jul 2025, 256K context)
|
|
29
|
+
| 'codestral-2501'
|
|
30
|
+
| 'devstral-medium-2507' // Devstral (coding agents)
|
|
31
|
+
| 'ministral-3b-2512'
|
|
32
|
+
| 'ministral-8b-2512'
|
|
33
|
+
| 'ministral-14b-2512'
|
|
34
|
+
| 'ministral-3b-2410'
|
|
35
|
+
| 'ministral-8b-2410'
|
|
36
|
+
| 'open-mistral-nemo';
|
|
17
37
|
|
|
18
38
|
export type MistralEmbeddingModel = 'mistral-embed';
|
|
19
39
|
|
|
40
|
+
export type MistralOCRModel = 'mistral-ocr-2512' | 'mistral-ocr-2505';
|
|
41
|
+
|
|
42
|
+
export type MistralAudioModel = 'voxtral-mini-2602' | 'voxtral-mini-transcribe-realtime-2602' | 'voxtral-mini-2507';
|
|
43
|
+
|
|
20
44
|
export const MISTRAL_MODELS: MistralModel[] = [
|
|
45
|
+
// Latest aliases
|
|
21
46
|
'mistral-large-latest',
|
|
47
|
+
'mistral-medium-latest',
|
|
22
48
|
'mistral-small-latest',
|
|
23
49
|
'codestral-latest',
|
|
50
|
+
'magistral-medium-latest',
|
|
24
51
|
'ministral-8b-latest',
|
|
25
52
|
'ministral-3b-latest',
|
|
26
|
-
'open-mistral-nemo',
|
|
27
53
|
'pixtral-large-latest',
|
|
54
|
+
'devstral-latest',
|
|
55
|
+
// Pinned versions
|
|
56
|
+
'mistral-large-2512',
|
|
57
|
+
'mistral-medium-2508',
|
|
58
|
+
'magistral-medium-2509',
|
|
59
|
+
'codestral-2508',
|
|
60
|
+
'devstral-medium-2507',
|
|
61
|
+
'ministral-14b-2512',
|
|
62
|
+
'open-mistral-nemo',
|
|
28
63
|
];
|
|
29
64
|
|
|
30
65
|
// Chat Completions
|
|
@@ -156,7 +191,7 @@ export interface EmbeddingOptions {
|
|
|
156
191
|
model?: MistralEmbeddingModel | string;
|
|
157
192
|
}
|
|
158
193
|
|
|
159
|
-
export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-
|
|
194
|
+
export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-medium-latest';
|
|
160
195
|
export const DEFAULT_EMBEDDING_MODEL: MistralEmbeddingModel = 'mistral-embed';
|
|
161
196
|
|
|
162
197
|
// Common types
|
|
@@ -47,6 +47,17 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Notes (2026)
|
|
51
|
+
|
|
52
|
+
Base URLs:
|
|
53
|
+
- Ingestion: `https://api.mixpanel.com/`
|
|
54
|
+
- Query (EU): `https://eu.mixpanel.com/api/query/`
|
|
55
|
+
|
|
56
|
+
Auth: Service Account credentials (username:password as HTTP Basic Auth) for Query API. Project token for Ingestion API.
|
|
57
|
+
|
|
58
|
+
Key endpoints: `/track` (events), `/engage` (user profiles), `/groups` (group analytics), `/import` (batch import).
|
|
59
|
+
Query API: `/segmentation`, `/funnel`, `/retention`, `/events`.
|
|
60
|
+
|
|
50
61
|
## Authentication
|
|
51
62
|
|
|
52
63
|
API Key authentication. Credentials can be set via:
|
|
@@ -56,6 +56,36 @@ src/
|
|
|
56
56
|
└── index.ts # Library exports
|
|
57
57
|
```
|
|
58
58
|
|
|
59
|
+
## API Version (2026) — BREAKING CHANGES
|
|
60
|
+
|
|
61
|
+
### Current Version: `2026-03-11`
|
|
62
|
+
Set header: `Notion-Version: 2026-03-11`
|
|
63
|
+
SDK: upgrade to `@notionhq/client` v5.12.0+
|
|
64
|
+
|
|
65
|
+
### Breaking Changes in `2026-03-11`
|
|
66
|
+
|
|
67
|
+
| Change | Old (`2025-09-03`) | New (`2026-03-11`) |
|
|
68
|
+
|--------|-------------------|-------------------|
|
|
69
|
+
| Block positioning | `after: "block-id"` string | `position: { type: "after_block", after_block: { id: "..." } }` |
|
|
70
|
+
| Trash status | `archived: true/false` | `in_trash: true/false` |
|
|
71
|
+
| Block type | `transcription` | `meeting_notes` |
|
|
72
|
+
|
|
73
|
+
#### 1. Replace `after` → `position` (Append Block Children)
|
|
74
|
+
```json
|
|
75
|
+
// NEW: PATCH /v1/blocks/{id}/children
|
|
76
|
+
{ "position": { "type": "after_block", "after_block": { "id": "b5d8fd79-..." } }, "children": [...] }
|
|
77
|
+
// position types: "after_block", "start", "end"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
#### 2. Replace `archived` → `in_trash`
|
|
81
|
+
```json
|
|
82
|
+
// NEW: PATCH /v1/pages/{id}
|
|
83
|
+
{ "in_trash": true }
|
|
84
|
+
```
|
|
85
|
+
Applies to pages, databases, blocks, and data sources in both requests AND responses.
|
|
86
|
+
|
|
87
|
+
#### 3. Replace `transcription` → `meeting_notes` block type
|
|
88
|
+
|
|
59
89
|
## Authentication
|
|
60
90
|
|
|
61
91
|
Two authentication methods supported:
|
|
@@ -6,6 +6,21 @@ This file provides guidance to AI coding agents when working with this repositor
|
|
|
6
6
|
|
|
7
7
|
connect-openai is a TypeScript CLI and library for OpenAI's API. It provides chat completions, embeddings, and image generation with multi-profile support.
|
|
8
8
|
|
|
9
|
+
## Models (2026)
|
|
10
|
+
|
|
11
|
+
| Model | Description |
|
|
12
|
+
|-------|-------------|
|
|
13
|
+
| `gpt-5.4` | Latest, most capable |
|
|
14
|
+
| `gpt-4.1-mini` | Fast, cheap — **use as default** |
|
|
15
|
+
| `gpt-4.1` | High capability |
|
|
16
|
+
| `o3` | Advanced reasoning |
|
|
17
|
+
| `o4-mini` | Fast reasoning |
|
|
18
|
+
| `gpt-image-1` | Image generation (preferred over DALL-E 3) |
|
|
19
|
+
|
|
20
|
+
Default: `gpt-4.1-mini`
|
|
21
|
+
|
|
22
|
+
Note: GPT-4o, GPT-4.1, o4-mini retired from **ChatGPT** Feb 2026 — still available in API.
|
|
23
|
+
|
|
9
24
|
## Build & Run Commands
|
|
10
25
|
|
|
11
26
|
```bash
|
|
@@ -47,6 +47,29 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Models (2026)
|
|
51
|
+
|
|
52
|
+
| Model | Description |
|
|
53
|
+
|-------|-------------|
|
|
54
|
+
| `gpt-5.4` | Latest GPT-5, most capable |
|
|
55
|
+
| `gpt-5.2` / `gpt-5.1` | GPT-5 variants |
|
|
56
|
+
| `gpt-4.1` | High-capability, cost-effective |
|
|
57
|
+
| `gpt-4.1-mini` | Fast and cheap — **recommended default** |
|
|
58
|
+
| `gpt-4o` | Still supported in API (retired from ChatGPT Feb 2026) |
|
|
59
|
+
| `o4-mini` | Reasoning model, fast |
|
|
60
|
+
| `o3` | Advanced reasoning |
|
|
61
|
+
| `gpt-image-1` | Native image generation (replaces DALL-E 3 for new projects) |
|
|
62
|
+
|
|
63
|
+
Default: `gpt-4.1-mini`
|
|
64
|
+
|
|
65
|
+
## Responses API (2025+)
|
|
66
|
+
|
|
67
|
+
For agentic use cases, prefer the **Responses API** over Chat Completions:
|
|
68
|
+
- Built-in tools: file search, code interpreter, image generation, MCP support
|
|
69
|
+
- Stateful conversations
|
|
70
|
+
- Endpoint: `POST /v1/responses`
|
|
71
|
+
- Use Chat Completions for simple text generation; Responses API for agents
|
|
72
|
+
|
|
50
73
|
## Authentication
|
|
51
74
|
|
|
52
75
|
Bearer Token authentication. Credentials can be set via:
|
|
@@ -6,39 +6,61 @@ export interface OpenAIConfig {
|
|
|
6
6
|
organization?: string;
|
|
7
7
|
}
|
|
8
8
|
|
|
9
|
-
// Models
|
|
9
|
+
// Models (2026)
|
|
10
10
|
export type OpenAIModel =
|
|
11
|
+
// GPT-5 series (2025-2026, latest)
|
|
12
|
+
| 'gpt-5.4'
|
|
13
|
+
| 'gpt-5.2'
|
|
14
|
+
| 'gpt-5.1'
|
|
15
|
+
| 'gpt-5'
|
|
16
|
+
// GPT-4.1 series (2025)
|
|
17
|
+
| 'gpt-4.1'
|
|
18
|
+
| 'gpt-4.1-mini'
|
|
19
|
+
// GPT-4o (still supported in API)
|
|
11
20
|
| 'gpt-4o'
|
|
12
21
|
| 'gpt-4o-mini'
|
|
22
|
+
// o-series reasoning models
|
|
23
|
+
| 'o4-mini'
|
|
24
|
+
| 'o3'
|
|
25
|
+
| 'o3-mini'
|
|
26
|
+
| 'o1'
|
|
27
|
+
// Legacy
|
|
13
28
|
| 'gpt-4-turbo'
|
|
14
29
|
| 'gpt-4'
|
|
15
|
-
| 'gpt-3.5-turbo'
|
|
16
|
-
| 'o1'
|
|
17
|
-
| 'o1-mini'
|
|
18
|
-
| 'o1-preview'
|
|
19
|
-
| 'o3-mini';
|
|
30
|
+
| 'gpt-3.5-turbo';
|
|
20
31
|
|
|
21
32
|
export type EmbeddingModel =
|
|
22
33
|
| 'text-embedding-3-small'
|
|
23
34
|
| 'text-embedding-3-large'
|
|
24
35
|
| 'text-embedding-ada-002';
|
|
25
36
|
|
|
26
|
-
export type ImageModel = 'dall-e-3' | 'dall-e-2';
|
|
37
|
+
export type ImageModel = 'gpt-image-1' | 'dall-e-3' | 'dall-e-2';
|
|
27
38
|
|
|
28
|
-
export type TTSModel = 'tts-1' | 'tts-1-hd';
|
|
39
|
+
export type TTSModel = 'tts-1' | 'tts-1-hd' | 'gpt-4o-mini-tts';
|
|
29
40
|
|
|
30
|
-
export type STTModel = 'whisper-1';
|
|
41
|
+
export type STTModel = 'whisper-1' | 'gpt-4o-transcribe';
|
|
31
42
|
|
|
32
43
|
export const OPENAI_MODELS: OpenAIModel[] = [
|
|
44
|
+
// GPT-5 series
|
|
45
|
+
'gpt-5.4',
|
|
46
|
+
'gpt-5.2',
|
|
47
|
+
'gpt-5.1',
|
|
48
|
+
'gpt-5',
|
|
49
|
+
// GPT-4.1
|
|
50
|
+
'gpt-4.1',
|
|
51
|
+
'gpt-4.1-mini',
|
|
52
|
+
// GPT-4o
|
|
33
53
|
'gpt-4o',
|
|
34
54
|
'gpt-4o-mini',
|
|
55
|
+
// o-series
|
|
56
|
+
'o4-mini',
|
|
57
|
+
'o3',
|
|
58
|
+
'o3-mini',
|
|
59
|
+
'o1',
|
|
60
|
+
// Legacy
|
|
35
61
|
'gpt-4-turbo',
|
|
36
62
|
'gpt-4',
|
|
37
63
|
'gpt-3.5-turbo',
|
|
38
|
-
'o1',
|
|
39
|
-
'o1-mini',
|
|
40
|
-
'o1-preview',
|
|
41
|
-
'o3-mini',
|
|
42
64
|
];
|
|
43
65
|
|
|
44
66
|
// Chat Completions
|
|
@@ -213,7 +235,7 @@ export interface ImageOptions {
|
|
|
213
235
|
n?: number;
|
|
214
236
|
}
|
|
215
237
|
|
|
216
|
-
export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-
|
|
238
|
+
export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-4.1-mini';
|
|
217
239
|
export const DEFAULT_EMBEDDING_MODEL: EmbeddingModel = 'text-embedding-3-small';
|
|
218
240
|
export const DEFAULT_IMAGE_MODEL: ImageModel = 'dall-e-3';
|
|
219
241
|
|
|
@@ -47,6 +47,14 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Notes (2026)
|
|
51
|
+
|
|
52
|
+
Current version: **API 3.0** (One Call API 3.0) — requires subscription.
|
|
53
|
+
- Free tier: `https://api.openweathermap.org/data/2.5/` (weather, forecast)
|
|
54
|
+
- API 3.0: `https://api.openweathermap.org/data/3.0/onecall` (includes minutely, hourly, daily, alerts)
|
|
55
|
+
- Air Pollution: `https://api.openweathermap.org/data/2.5/air_pollution`
|
|
56
|
+
- Auth: `?appid={API_KEY}` query parameter
|
|
57
|
+
|
|
50
58
|
## Authentication
|
|
51
59
|
|
|
52
60
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,24 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Updates (2025)
|
|
51
|
+
|
|
52
|
+
### New API Capabilities (Jun 2025)
|
|
53
|
+
- **Update documents with images** via API
|
|
54
|
+
- **Create templates from URLs** (no manual upload)
|
|
55
|
+
- **SMS consent tracking** via API
|
|
56
|
+
- **Editing session tokens** without adding users
|
|
57
|
+
- **Programmatic API key creation** for workspace setup automation
|
|
58
|
+
|
|
59
|
+
### Document Settings Changes (v7.14.0)
|
|
60
|
+
- `expires_in` property added to `GET/PATCH /documents/{id}/settings` responses
|
|
61
|
+
- `qualified_electronic_signature` removed from template settings
|
|
62
|
+
|
|
63
|
+
### Integrations (Jun 2025)
|
|
64
|
+
- PandaDoc CPQ for Pipedrive (two-way sync)
|
|
65
|
+
- QuickBooks Online integration (estimates + invoices)
|
|
66
|
+
- Recurring payments via Stripe from documents
|
|
67
|
+
|
|
50
68
|
## Authentication
|
|
51
69
|
|
|
52
70
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,11 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Notes (2026)
|
|
51
|
+
|
|
52
|
+
Quo business quoting and invoicing API. Check https://quo.app/docs for latest API reference.
|
|
53
|
+
Auth: API key via Authorization header.
|
|
54
|
+
|
|
50
55
|
## Authentication
|
|
51
56
|
|
|
52
57
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,26 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API & Pricing (2026)
|
|
51
|
+
|
|
52
|
+
### Rate Limits
|
|
53
|
+
- **Authenticated (OAuth)**: 60 requests/minute (10-minute rolling window, per OAuth client)
|
|
54
|
+
- **Unauthenticated**: 10 requests/minute (IP-based)
|
|
55
|
+
- Response headers: `X-Ratelimit-Used`, `X-Ratelimit-Remaining`, `X-Ratelimit-Reset`
|
|
56
|
+
|
|
57
|
+
### Pricing Tiers (2023+, still in effect 2026)
|
|
58
|
+
| Tier | Rate | Cost |
|
|
59
|
+
|------|------|------|
|
|
60
|
+
| Free | 100 req/min | Free (non-commercial only) |
|
|
61
|
+
| Premium | 100-1000 req/min | From $12,000/year |
|
|
62
|
+
| Enterprise | Custom | Custom (>1000 req/min) |
|
|
63
|
+
|
|
64
|
+
Note: Free tier is 60 req/min for OAuth apps, ~100 req/min for elevated access.
|
|
65
|
+
|
|
66
|
+
### Auth
|
|
67
|
+
OAuth 2.0 (client_credentials for scripts, authorization_code for user apps).
|
|
68
|
+
Required User-Agent format: `platform:app_name:version (by /u/username)`
|
|
69
|
+
|
|
50
70
|
## Authentication
|
|
51
71
|
|
|
52
72
|
OAuth authentication. Credentials can be set via:
|
|
@@ -47,6 +47,22 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Updates (2025-2026)
|
|
51
|
+
|
|
52
|
+
### New Endpoints
|
|
53
|
+
- **`POST /edit`** — Write-back document editing. Fill PDF forms and modify DOCX files using natural language instructions. Supports vision-based field detection for PDFs without native form fields.
|
|
54
|
+
- **Pipeline IDs** — Run Studio pipelines from code using stable pipeline identifiers. Tracks latest deployed config.
|
|
55
|
+
|
|
56
|
+
### Edit Endpoint (2026)
|
|
57
|
+
Input: `document_url`, `edit_instructions`, `edit_options` (provider preference: OpenAI/Anthropic/Google, highlight color, overflow behavior), optional `form_schema`.
|
|
58
|
+
Output: `document_url` + metadata of changes applied.
|
|
59
|
+
|
|
60
|
+
### Enterprise Features
|
|
61
|
+
- HIPAA/SOC 2 compliance
|
|
62
|
+
- On-prem/air-gapped deployment
|
|
63
|
+
- Zero data retention option
|
|
64
|
+
- BAA support for healthcare
|
|
65
|
+
|
|
50
66
|
## Authentication
|
|
51
67
|
|
|
52
68
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,27 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Updates (2025-2026)
|
|
51
|
+
|
|
52
|
+
### New Endpoints
|
|
53
|
+
- **`GET /emails`** (Oct 2025) — List sent emails with cursor-based pagination (`before`, `after`, `limit` params; max 100 per page)
|
|
54
|
+
- **Email suppression status** (Jan 2026) — New `suppressed` delivery status in email responses when Resend prevents delivery due to bounce/complaint history
|
|
55
|
+
|
|
56
|
+
### Email Suppression (Jan 2026)
|
|
57
|
+
New `last_event: "suppressed"` status in email objects. New `email.suppressed` webhook event. Webhooks include suppression type (`OnAccountSuppressionList`) and message.
|
|
58
|
+
|
|
59
|
+
### Endpoints Overview
|
|
60
|
+
| Method | Path | Description |
|
|
61
|
+
|--------|------|-------------|
|
|
62
|
+
| POST | `/emails` | Send email |
|
|
63
|
+
| GET | `/emails/{id}` | Get email |
|
|
64
|
+
| GET | `/emails` | **New** List sent emails |
|
|
65
|
+
| GET/POST/DELETE | `/domains` | Domain management |
|
|
66
|
+
| GET/POST/DELETE | `/api-keys` | API key management |
|
|
67
|
+
| GET/POST/DELETE | `/audiences` | Contact lists |
|
|
68
|
+
| GET/POST/DELETE | `/contacts` | Contacts in audience |
|
|
69
|
+
| GET/POST/DELETE | `/broadcasts` | Email broadcasts |
|
|
70
|
+
|
|
50
71
|
## Authentication
|
|
51
72
|
|
|
52
73
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,23 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Updates (2025-2026)
|
|
51
|
+
|
|
52
|
+
### Open Banking API Breaking Changes (Mar 23, 2026)
|
|
53
|
+
1. **OpenID issuer URL** changes from `https://oba.revolut.com` to `https://oba-auth.revolut.com`. Both will be accepted temporarily — update promptly.
|
|
54
|
+
2. **AccountSubType for Credit Cards**: Changes from `Loan` → `CreditCard`
|
|
55
|
+
3. **DCR scope parameter**: Unified to space-separated string (e.g., `"openid accounts payments"`) across all DCR endpoints. Was inconsistently array vs string.
|
|
56
|
+
|
|
57
|
+
### New Endpoints (2025)
|
|
58
|
+
- Merchant API: **Disputes endpoints** (Jun 2025) — retrieve, list, and now act on disputes directly
|
|
59
|
+
- Merchant API: **Apple Pay unregistration endpoint** (Jun 2025)
|
|
60
|
+
- **Pay by Bank** (May 2025) — new payment method for direct bank account payments
|
|
61
|
+
|
|
62
|
+
### Auth Changes (Mar-Apr 2025)
|
|
63
|
+
- FAPI 1.0 Advanced: API endpoint subdomain changed from `oba.revolut.com` to `oba-auth.revolut.com`
|
|
64
|
+
- OAuth refresh token expiry updated (Apr 7, 2025)
|
|
65
|
+
- Public API specs now available on GitHub (Jul 2025)
|
|
66
|
+
|
|
50
67
|
## Authentication
|
|
51
68
|
|
|
52
69
|
Bearer Token authentication. Credentials can be set via:
|
|
@@ -47,6 +47,12 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Notes (2026)
|
|
51
|
+
|
|
52
|
+
Sedo Domain Marketplace API: `https://api.sedo.com/api/v2/`
|
|
53
|
+
Key endpoints: domain search, listings, pricing, transfers, parking statistics.
|
|
54
|
+
Auth: API key + partner ID.
|
|
55
|
+
|
|
50
56
|
## Authentication
|
|
51
57
|
|
|
52
58
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,17 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Design (2025+)
|
|
51
|
+
|
|
52
|
+
Sentry overhauled API guidelines (Apr 2025). Key design principles now enforced:
|
|
53
|
+
- All endpoints designed as public API
|
|
54
|
+
- `PATCH` not used — `PUT` for updates
|
|
55
|
+
- Noun-based nesting in responses (`{project: {...}}` not flat)
|
|
56
|
+
- Identifiers accept both human-readable and numeric forms
|
|
57
|
+
- Common names used (`organization` not `organization_id`)
|
|
58
|
+
|
|
59
|
+
New endpoint (Jul 2025): `POST /api/0/repositories/{repo}/token/regen/` — Regenerate repository upload token.
|
|
60
|
+
|
|
50
61
|
## Authentication
|
|
51
62
|
|
|
52
63
|
Bearer Token authentication. Credentials can be set via:
|
|
@@ -47,6 +47,48 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## CLI v4 (Mar 2026) — Major Update
|
|
51
|
+
|
|
52
|
+
shadcn CLI v4 released March 2026. Key new features:
|
|
53
|
+
|
|
54
|
+
### New Inspection Flags
|
|
55
|
+
```bash
|
|
56
|
+
npx shadcn@latest add button --dry-run # preview without writing
|
|
57
|
+
npx shadcn@latest add button --diff # show diff vs local changes
|
|
58
|
+
npx shadcn@latest add button --view # inspect registry payload
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Presets — Design System Codes
|
|
62
|
+
Pack entire design system (colors, theme, icons, fonts, radius) into a short code:
|
|
63
|
+
```bash
|
|
64
|
+
npx shadcn@latest init --preset a1Dg5eFl # scaffold with preset
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### shadcn/skills — Agent Context
|
|
68
|
+
Gives AI coding agents context for working with components:
|
|
69
|
+
```bash
|
|
70
|
+
npx skills add shadcn/ui
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### New shadcn info command
|
|
74
|
+
```bash
|
|
75
|
+
npx shadcn@latest info # framework, version, installed components, docs links
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### shadcn docs command
|
|
79
|
+
```bash
|
|
80
|
+
npx shadcn@latest docs combobox # get docs, code, examples for any component
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### shadcn init Templates (--template, --monorepo, --base)
|
|
84
|
+
```bash
|
|
85
|
+
npx shadcn@latest init -t next --monorepo # next.js monorepo
|
|
86
|
+
npx shadcn@latest init --base radix # choose Radix or Base UI primitives
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### registry:base and registry:font
|
|
90
|
+
Registries can now distribute entire design systems and fonts as first-class types.
|
|
91
|
+
|
|
50
92
|
## Authentication
|
|
51
93
|
|
|
52
94
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,24 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Migration (2025-2026) — IMPORTANT
|
|
51
|
+
|
|
52
|
+
### REST API is Legacy
|
|
53
|
+
Shopify marked REST Admin API as **legacy as of October 1, 2024**.
|
|
54
|
+
|
|
55
|
+
- **New public apps**: Must use GraphQL Admin API exclusively (since April 1, 2025)
|
|
56
|
+
- **Custom apps**: Can still use REST but won't receive new features; can't increase product variants past 100
|
|
57
|
+
- REST API for products/variants: Must migrate to GraphQL if supporting >100 variants
|
|
58
|
+
- Current API version: **`2026-01`**
|
|
59
|
+
|
|
60
|
+
### GraphQL Admin API
|
|
61
|
+
All new development should use GraphQL:
|
|
62
|
+
- Endpoint: `POST https://{shop}.myshopify.com/admin/api/2026-01/graphql.json`
|
|
63
|
+
- Auth header: `X-Shopify-Access-Token: {access_token}`
|
|
64
|
+
|
|
65
|
+
### Check Deprecated Calls
|
|
66
|
+
Use `GET /admin/api/2026-01/deprecated_api_calls.json` to audit deprecated API usage in your custom app (last 30 days).
|
|
67
|
+
|
|
50
68
|
## Authentication
|
|
51
69
|
|
|
52
70
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,12 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Notes (2026)
|
|
51
|
+
|
|
52
|
+
Snapchat Marketing API (Ads API): `https://adsapi.snapchat.com/v1/`
|
|
53
|
+
Auth: OAuth 2.0 (client credentials flow for server-to-server)
|
|
54
|
+
Key resources: campaigns, ad_squads, ads, creatives, audiences, pixel, stats.
|
|
55
|
+
|
|
50
56
|
## Authentication
|
|
51
57
|
|
|
52
58
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,19 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## Models (2025-2026)
|
|
51
|
+
|
|
52
|
+
| Model | Endpoint | Description |
|
|
53
|
+
|-------|----------|-------------|
|
|
54
|
+
| `sd3.5-large` | `/v2beta/stable-image/generate/sd3` | Highest quality |
|
|
55
|
+
| `sd3.5-large-turbo` | `/v2beta/stable-image/generate/sd3` | Fast SD 3.5 |
|
|
56
|
+
| `sd3.5-medium` | `/v2beta/stable-image/generate/sd3` | Balanced, MMDiT-X arch |
|
|
57
|
+
| `stable-image-ultra` | `/v2beta/stable-image/generate/ultra` | Ultra quality |
|
|
58
|
+
| `stable-image-core` | `/v2beta/stable-image/generate/core` | Fast and affordable |
|
|
59
|
+
|
|
60
|
+
SD 3.5 Medium: Keep prompts under 256 T5 tokens. Use Skip Layer Guidance for better anatomy.
|
|
61
|
+
License: Community License free for <$1M annual revenue; Enterprise required above.
|
|
62
|
+
|
|
50
63
|
## Authentication
|
|
51
64
|
|
|
52
65
|
API Key authentication. Credentials can be set via:
|
|
@@ -47,6 +47,25 @@ src/
|
|
|
47
47
|
└── index.ts # Library exports
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
+
## API Version (2026)
|
|
51
|
+
|
|
52
|
+
Current version: **`2026-02-25.clover`**
|
|
53
|
+
|
|
54
|
+
Stripe uses versioned releases. The current major release is **Clover** (2026). Set `Stripe-Version` header to pin a version:
|
|
55
|
+
```typescript
|
|
56
|
+
'Stripe-Version': '2026-02-25.clover'
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Notable Clover changes:
|
|
60
|
+
- `adjustable_quantity` returned in LineItem objects (Checkout Sessions, Payment Links, Quotes)
|
|
61
|
+
- Amount-off coupons with `duration=forever` re-enabled (was deprecated in Basil 2025-03-31)
|
|
62
|
+
|
|
63
|
+
### Stripe Agent Toolkit (2025+)
|
|
64
|
+
Stripe now has an official Agent Toolkit and MCP Server for AI integrations. See [docs.stripe.com/agent-toolkit](https://docs.stripe.com/agent-toolkit).
|
|
65
|
+
|
|
66
|
+
### Workbench
|
|
67
|
+
Use [Stripe Workbench](https://dashboard.stripe.com/workbench) to manage your API version and test API changes in-browser. Replaces the old API Explorer.
|
|
68
|
+
|
|
50
69
|
## Authentication
|
|
51
70
|
|
|
52
71
|
Bearer Token authentication. Credentials can be set via:
|