Other Resources
Quick reference for the remaining /api/v1 resources. Each links to the Core Concepts page with full conceptual detail and field tables.
Connectors
| Endpoint | Description |
|---|---|
GET /api/v1/connectors | List all available connectors and their actions/auth requirements. |
GET /api/v1/connectors/{name} | Detail for one connector — actions, parameters, required credential fields. |
Secrets
| Endpoint | Auth | Description |
|---|---|---|
GET /api/v1/secrets | any | List secret names for the tenant (values are never returned). |
POST /api/v1/secrets | admin/owner | Create/update a named secret — {"name": "OPENAI_API_KEY", "value": "sk-..."}. AES-256-GCM encrypted at rest. |
DELETE /api/v1/secrets/{name} | admin/owner | Delete a secret. |
See Secrets & Credentials — Encryption.
OAuth connections
Browser-redirect flows (public, no JWT — the browser can't send Authorization headers):
| Endpoint | Description |
|---|---|
GET /api/v1/oauth/google/authorize / .../callback | Google connector OAuth (Sheets, Calendar, Gmail, Drive). |
GET /api/v1/oauth/notion/authorize / .../callback | Notion connector OAuth. |
GET /api/v1/oauth/slack/authorize / .../callback | Slack connector OAuth. |
Authenticated management:
| Endpoint | Description |
|---|---|
GET /api/v1/oauth/status | Which OAuth providers are configured platform-wide. |
GET /api/v1/oauth/connections | List the tenant's connected accounts. |
DELETE /api/v1/oauth/connections/{id} | Disconnect an account. |
GET /api/v1/oauth/connections/{id}/token | Get a fresh access token (refreshes if expired). |
POST /api/v1/oauth/connections/{id}/refresh | Force-refresh a token. |
POST /api/v1/connections | Create a manual API-key-based connection (for connectors without OAuth, e.g. {"connector": "github", "credentials": {"token": "..."}}). |
See Secrets & Credentials — OAuth connections.
Knowledge Bases
| Endpoint | Description |
|---|---|
GET /api/v1/knowledge-bases | List KBs. |
POST /api/v1/knowledge-bases | Create a KB (embedding provider/model config). |
GET /api/v1/knowledge-bases/{id} | Get KB detail. |
DELETE /api/v1/knowledge-bases/{id} | Delete a KB and its documents/chunks. |
GET /api/v1/knowledge-bases/{id}/documents | List documents. |
POST /api/v1/knowledge-bases/{id}/documents | Add a document by URL/text. |
POST /api/v1/knowledge-bases/{id}/documents/upload | Upload a file (PDF, DOCX, etc.) for chunking + embedding. |
DELETE /api/v1/knowledge-bases/{id}/documents/{docId} | Remove a document and its chunks. |
POST /api/v1/knowledge-bases/{id}/query | Semantic search — {"query": "...", "top_k": 5}. |
See Knowledge Bases.
Skills
| Endpoint | Description |
|---|---|
GET /api/v1/skills | List the tenant's skills. |
GET /api/v1/skills/published | List skills published to the public registry. |
POST /api/v1/skills | Create a skill (SKILL.md + scripts/references). |
POST /api/v1/skills/parse | Parse an uploaded skill bundle (zip) into a structured skill. |
GET /api/v1/skills/registry/search?q= | Search the public skill registry. |
POST /api/v1/skills/registry/install | Install a registry skill into the tenant. |
GET /api/v1/skills/{id} / PUT / DELETE | Get/update/delete a skill. |
POST /api/v1/skills/{id}/publish / unpublish | Publish/unpublish a skill to the registry. |
See Skills.
Team
| Endpoint | Auth | Description |
|---|---|---|
GET /api/v1/team/members | admin/owner | List tenant members and roles. |
POST /api/v1/team/invite | admin/owner | Invite a member by email with a role. |
PUT /api/v1/team/members/{id}/role | owner | Change a member's role. |
DELETE /api/v1/team/members/{id} | owner | Remove a member. |
See Teams, Organizations & Roles — User roles.
Organizations (Enterprise)
| Endpoint | Description |
|---|---|
POST /api/v1/organizations | Create an organization. |
GET /api/v1/organizations | List organizations. |
GET /api/v1/organizations/{id} | Get organization detail (member tenants). |
POST /api/v1/organizations/{id}/tenants/{tenantId} | Assign a tenant to an organization. |
See Teams, Organizations & Roles — Organizations.
Billing
| Endpoint | Auth | Description |
|---|---|---|
GET /api/v1/billing/plans | any | List the plan ladder (Free/Pro/Enterprise) with limits. |
GET /api/v1/billing/subscription | any | Current subscription/plan for the tenant. |
POST /api/v1/billing/checkout | owner | Create a Stripe Checkout session to upgrade. |
POST /api/v1/billing/portal | owner | Create a Stripe Customer Portal session. |
See Billing & Plans.
SSO config (Enterprise)
| Endpoint | Auth | Description |
|---|---|---|
GET /api/v1/sso/config | owner | Get the tenant's SAML/OIDC configuration. |
PUT /api/v1/sso/config | owner | Create/update SSO configuration. |
DELETE /api/v1/sso/config | owner | Remove SSO configuration. |
See Teams, Organizations & Roles — SSO. Login-time SSO routes are public — see Authentication.
Misc
| Endpoint | Description |
|---|---|
GET /api/v1/llm/models?provider=&api_key=&base_url= | List available models for an LLM provider (used to populate model dropdowns in the agent/LLM node config). Accepts a {{ secret.NAME }} reference for api_key. |
POST /api/v1/playground/run | Run a single LLM prompt without a workflow — see Deploying Workflows — Prompt Playground. |
POST /api/v1/test/telegram | Send a test message to verify a Telegram bot token/chat ID. |
GET /api/v1/system/workers | admin/owner — Temporal worker pool status. |