Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: remove internal consumer API endpoints from public spec

Sushmithamallesh13f7fd770544
diff --git a/docs/content/reference/api-reference/organization-management/index.mdx b/docs/content/reference/api-reference/organization-management/index.mdx
deleted file mode 100644
index b6d8990ab..000000000
--- a/docs/content/reference/api-reference/organization-management/index.mdx
+++ /dev/null
@@ -1,14 +0,0 @@
----
-title: Organization Management
-description: "Organization Management API endpoints"
----
-
-{/* Auto-generated from OpenAPI spec. Do not edit directly. */}
-
-Organization Management API endpoints
-
-## Endpoints
-
-| Endpoint | Quick Link |
-|----------|------------|
-| `GET /api/v3/org/consumer/connected_toolkits` | [List active connected toolkits for a consumer user](/reference/api-reference/organization-management/getOrgConsumerConnectedToolkits) |
diff --git a/docs/content/reference/api-reference/projects/index.mdx b/docs/content/reference/api-reference/projects/index.mdx
index a5b2d031a..d1fb7a105 100644
--- a/docs/content/reference/api-reference/projects/index.mdx
+++ b/docs/content/reference/api-reference/projects/index.mdx
@@ -18,4 +18,3 @@ Projects API endpoints
| `GET /api/v3/org/owner/project/{nano_id}` | [Get project details by ID With Org Api key](/reference/api-reference/projects/getOrgOwnerProjectByNanoId) |
| `DELETE /api/v3/org/owner/project/{nano_id}` | [Delete a project](/reference/api-reference/projects/deleteOrgOwnerProjectByNanoId) |
| `POST /api/v3/org/owner/project/{nano_id}/regenerate_api_key` | [Delete and generate new API key for project](/reference/api-reference/projects/postOrgOwnerProjectByNanoIdRegenerateApiKey) |
-| `POST /api/v3/org/consumer/project/resolve` | [Resolve the organization consumer project](/reference/api-reference/projects/postOrgConsumerProjectResolve) |
diff --git a/docs/public/openapi.json b/docs/public/openapi.json
index 685af5880..d1eaa87ca 100644
--- a/docs/public/openapi.json
+++ b/docs/public/openapi.json
@@ -5786,251 +5786,6 @@
}
}
},
- "/api/v3/org/consumer/project/resolve": {
- "post": {
- "summary": "Resolve the organization consumer project",
- "description": "Finds the authenticated organization's single CONSUMER project and provisions it if absent. This endpoint is idempotent and never returns consumer API keys.",
- "tags": [
- "Projects"
- ],
- "operationId": "postOrgConsumerProjectResolve",
- "security": [
- {
- "UserApiKeyAuth": []
- }
- ],
- "parameters": [
- {
- "schema": {
- "type": "string",
- "minLength": 1,
- "description": "User API key used to authenticate the request.",
- "example": "uak_abc123xyz456..."
- },
- "required": true,
- "name": "x-user-api-key",
- "in": "header"
- },
- {
- "schema": {
- "type": "string",
- "format": "orgId",
- "description": "Organization nano ID that scopes the user API key resolution.",
- "example": "org_abc123xyz456"
- },
- "required": true,
- "name": "x-org-id",
- "in": "header"
- }
- ],
- "responses": {
- "200": {
- "description": "Consumer project resolved successfully.",
- "content": {
- "application/json": {
- "schema": {
- "type": "object",
- "properties": {
- "project_id": {
- "type": "string",
- "format": "uuid",
- "description": "UUID of the resolved consumer project."
- },
- "project_nano_id": {
- "type": "string",
- "format": "projectId",
- "description": "Nano ID of the resolved consumer project."
- },
- "project_name": {
- "type": "string",
- "description": "Name of the resolved consumer project."
- },
- "org_id": {
- "type": "string",
- "format": "orgId",
- "description": "Organization nano ID that owns the consumer project."
- },
- "project_type": {
- "type": "string",
- "enum": [
- "CONSUMER"
- ],
- "description": "Resolved project type."
- },
- "consumer_user_id": {
- "type": "string",
- "description": "Derived internal Composio user ID for the authenticated user in this consumer org context."
- }
- },
- "required": [
- "project_id",
- "project_nano_id",
- "project_name",
- "org_id",
- "project_type",
- "consumer_user_id"
- ]
- }
- }
- }
- },
- "400": {
- "description": "Bad request. x-org-id is required for user API key authentication.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "401": {
- "description": "Unauthorized. A valid user API key is required.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "403": {
- "description": "Forbidden.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "500": {
- "description": "Internal server error.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- }
- }
- }
- },
- "/api/v3/org/consumer/connected_toolkits": {
- "get": {
- "summary": "List active connected toolkits for a consumer user",
- "description": "Resolves the organization's single CONSUMER project and returns the distinct toolkit slugs for which the specified consumer user has an ACTIVE connection.",
- "tags": [
- "Organization Management"
- ],
- "operationId": "getOrgConsumerConnectedToolkits",
- "security": [
- {
- "UserApiKeyAuth": []
- }
- ],
- "parameters": [
- {
- "schema": {
- "type": "string",
- "minLength": 1,
- "description": "Consumer user ID to inspect within the consumer project."
- },
- "required": true,
- "description": "Consumer user ID to inspect within the consumer project.",
- "name": "user_id",
- "in": "query"
- },
- {
- "schema": {
- "type": "string",
- "minLength": 1,
- "description": "User API key used to authenticate the request.",
- "example": "uak_abc123xyz456..."
- },
- "required": true,
- "name": "x-user-api-key",
- "in": "header"
- },
- {
- "schema": {
- "type": "string",
- "minLength": 1,
- "description": "Organization nano ID that owns the consumer project."
- },
- "required": true,
- "description": "Organization nano ID that owns the consumer project.",
- "name": "x-org-id",
- "in": "header"
- }
- ],
- "responses": {
- "200": {
- "description": "Active consumer connected toolkits retrieved successfully.",
- "content": {
- "application/json": {
- "schema": {
- "type": "object",
- "properties": {
- "toolkits": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "description": "Distinct active toolkit slugs."
- }
- },
- "required": [
- "toolkits"
- ]
- }
- }
- }
- },
- "400": {
- "description": "Bad request.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "401": {
- "description": "Unauthorized.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "404": {
- "description": "User not found in organization.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- },
- "500": {
- "description": "Internal server error.",
- "content": {
- "application/json": {
- "schema": {
- "$ref": "#/components/schemas/Error"
- }
- }
- }
- }
- }
- }
- },
"/api/v3/webhook_subscriptions": {
"post": {
"summary": "Create webhook subscription",
@@ -15711,7 +15466,7 @@
"original_slug"
]
},
- "description": "Custom tools — standalone or extending Composio toolkits"
+ "description": "Custom tools \u2014 standalone or extending Composio toolkits"
}
},
"description": "Experimental features including the generated system prompt. Only returned on session creation, not on GET.",
@@ -16534,7 +16289,7 @@
"original_slug"
]
},
- "description": "Custom tools — standalone or extending Composio toolkits"
+ "description": "Custom tools \u2014 standalone or extending Composio toolkits"
}
},
"description": "Experimental features",
@@ -16741,7 +16496,7 @@
"/api/v3/tool_router/session/{session_id}/proxy_execute": {
"post": {
"summary": "Execute proxy request within a tool router session",
- "description": "Execute any native API call on a toolkit with authentication automatically injected from Composio. This endpoint proxies HTTP requests to third-party APIs using connected account credentials resolved from the session context. Provide the toolkit slug, API endpoint, and HTTP method — Composio handles authentication injection, abstracting away credential management. Supports all HTTP methods, custom headers/query parameters, and binary request/response bodies.",
+ "description": "Execute any native API call on a toolkit with authentication automatically injected from Composio. This endpoint proxies HTTP requests to third-party APIs using connected account credentials resolved from the session context. Provide the toolkit slug, API endpoint, and HTTP method \u2014 Composio handles authentication injection, abstracting away credential management. Supports all HTTP methods, custom headers/query parameters, and binary request/response bodies.",
"tags": [
"Tool Router"
],
@@ -18440,7 +18195,7 @@
"properties": {
"upload_url": {
"type": "string",
- "description": "Presigned upload URL — PUT the file content here"
+ "description": "Presigned upload URL \u2014 PUT the file content here"
},
"mount_relative_path": {
"type": "string",
@@ -18511,7 +18266,7 @@
"/api/v3/tool_router/session/{session_id}/mounts/{mount_id}/delete": {
"post": {
"summary": "Delete a file from a session mount",
- "description": "Deletes a file from a workbench session storage mount. S3 delete is idempotent — deleting a non-existent file succeeds silently.",
+ "description": "Deletes a file from a workbench session storage mount. S3 delete is idempotent \u2014 deleting a non-existent file succeeds silently.",
"tags": [
"Tool Router"
],
@@ -18762,4 +18517,4 @@
}
}
}
-}
\ No newline at end of file
+}