{ "openapi": "3.1.0", "info": { "title": "Arc0 management API", "version": "1.0.0", "description": "Project-bound business management. Runtime and embedded-session APIs retain their separate contracts. Required Arc0 scopes are listed in x-arc0-scopes." }, "servers": [ { "url": "https://api.arc0.ai" } ], "paths": { "/v1/funded-access": { "get": { "operationId": "get_funded_access", "summary": "get funded access", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "funded_access:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_funded_access_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "set_funded_access", "summary": "set funded access", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "funded_access:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/set_funded_access_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/mcp-oauth-clients": { "get": { "operationId": "get_mcp_oauth_settings", "summary": "get mcp oauth settings", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_mcp_oauth_settings_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "create_mcp_oauth_client", "summary": "create mcp oauth client", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "minLength": 1, "maxLength": 100 }, "client": { "type": "object", "properties": { "issuer": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "clientId": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$", "writeOnly": true }, "authMethod": { "type": "string", "enum": [ "none", "client_secret_basic", "client_secret_post" ] }, "source": { "type": "string", "const": "byo" } }, "required": [ "issuer", "clientId", "authMethod", "source" ], "additionalProperties": false } }, "required": [ "app", "client" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_mcp_oauth_client_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/mcp-oauth-clients/{id}/rotate": { "post": { "operationId": "rotate_mcp_oauth_client", "summary": "rotate mcp oauth client", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$", "writeOnly": true }, "clientId": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" } }, "required": [ "clientSecret" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/rotate_mcp_oauth_client_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/mcp-oauth-clients/{id}/retire": { "post": { "operationId": "retire_mcp_oauth_client", "summary": "retire mcp oauth client", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/retire_mcp_oauth_client_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/mcp-oauth-clients/{id}/select": { "post": { "operationId": "select_mcp_oauth_client", "summary": "select mcp oauth client", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/select_mcp_oauth_client_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/mcp-client-branding": { "put": { "operationId": "update_mcp_client_branding", "summary": "update mcp client branding", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "client_name": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[^\\p{Cc}\\p{Cf}<>]+$" }, "logo_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "client_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "policy_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "tos_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" } }, "required": [ "client_name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/update_mcp_client_branding_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/auth-configs": { "post": { "operationId": "create_auth_config", "summary": "create auth config", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "clientId": { "type": "string", "minLength": 1, "maxLength": 300 }, "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4000, "writeOnly": true } }, "required": [ "app", "name", "clientId", "clientSecret" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_auth_config_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "get": { "operationId": "list_auth_configs", "summary": "list auth configs", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_auth_configs_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/auth-configs/{id}/disable": { "post": { "operationId": "disable_auth_config", "summary": "disable auth config", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/disable_auth_config_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/approvals/{approvalId}": { "get": { "operationId": "get_approval", "summary": "get approval", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "approvals:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "approvalId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_approval_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/approvals/{approvalId}/decision": { "post": { "operationId": "decide_approval", "summary": "decide approval", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "approvals:decide" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "approvalId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "decision": { "type": "string", "enum": [ "approve", "deny" ] } }, "required": [ "decision" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/decide_approval_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/connect-settings": { "get": { "operationId": "get_connect_settings", "summary": "get connect settings", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect_settings:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_connect_settings_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "update_connect_branding", "summary": "update connect branding", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect_settings:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "displayName": { "type": "string", "minLength": 1, "maxLength": 100 }, "accentColor": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "logoUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "supportUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "theme": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "light", "dark", "system" ] }, "radius": { "type": "integer", "minimum": 0, "maximum": 24 }, "light": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false }, "dark": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false } }, "required": [ "mode", "radius", "light", "dark" ], "additionalProperties": false }, "hideArc0Badge": { "type": "boolean" } }, "required": [ "displayName", "accentColor" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/update_connect_branding_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/connect-settings/domains": { "post": { "operationId": "create_connect_domain", "summary": "create connect domain", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect_settings:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "hostname": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,63}$" } }, "required": [ "hostname" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_connect_domain_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/connect-settings/domains/{domainId}/verify": { "post": { "operationId": "verify_connect_domain", "summary": "verify connect domain", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect_settings:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "domainId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/verify_connect_domain_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/projects": { "get": { "operationId": "list_projects", "summary": "list projects", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_projects_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users": { "get": { "operationId": "list_end_users", "summary": "list end users", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } }, { "name": "health", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "active", "expired", "failed", "inactive" ] } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_end_users_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "create_end_user", "summary": "create end user", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "externalId": { "type": "string", "minLength": 1, "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "externalId", "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_end_user_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{endUserId}": { "get": { "operationId": "get_end_user", "summary": "get end user", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "endUserId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_end_user_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/users/{id}": { "put": { "operationId": "set_end_user", "summary": "set end user", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/set_end_user_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/groups": { "get": { "operationId": "list_groups", "summary": "list groups", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_groups_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "create_group", "summary": "create group", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "externalId": { "type": "string", "minLength": 1, "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "externalId", "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_group_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/groups/{id}": { "put": { "operationId": "set_group", "summary": "set group", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/set_group_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/memberships": { "get": { "operationId": "list_group_memberships", "summary": "list group memberships", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_group_memberships_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/groups/{groupId}/members": { "post": { "operationId": "add_group_member", "summary": "add group member", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "groupId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endUserId": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } }, "required": [ "endUserId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/add_group_member_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/groups/{groupId}/members/{endUserId}": { "delete": { "operationId": "remove_group_member", "summary": "remove group member", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "users:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "groupId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "endUserId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/remove_group_member_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/project-connections": { "get": { "operationId": "list_project_connections", "summary": "list project connections", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connections:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_project_connections_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/project-apps": { "get": { "operationId": "list_project_apps", "summary": "list project apps", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_project_apps_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "enable_app", "summary": "enable app", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "maxLength": 100 } }, "required": [ "app" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/enable_app_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/project-tools": { "get": { "operationId": "list_tools", "summary": "list tools", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_tools_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "configure_tool", "summary": "configure tool", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "action": { "type": "string", "minLength": 1, "maxLength": 256 }, "enabled": { "type": "boolean" }, "source": { "type": "string", "enum": [ "connection", "service_account", "platform", "public" ] }, "serviceAccountId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "offerId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "action", "enabled", "source" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/configure_tool_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/project-tools/{action}/pin": { "post": { "operationId": "pin_tool", "summary": "pin tool", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "action", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "version": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "version" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/pin_tool_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/project-apps/{app}/oauth-config": { "put": { "operationId": "select_auth_config", "summary": "select auth config", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "auth_configs:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "app", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 100 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "authConfigId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] } }, "required": [ "authConfigId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/select_auth_config_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/policy": { "get": { "operationId": "get_policy", "summary": "get policy", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "policies:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_policy_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "update_policy", "summary": "update policy", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "policies:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "read": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "write": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "destructive": { "type": "string", "enum": [ "allow", "deny", "ask" ] } }, "required": [ "read", "write", "destructive" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/update_policy_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/approvals": { "get": { "operationId": "list_approvals", "summary": "list approvals", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "approvals:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_approvals_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/audit": { "get": { "operationId": "get_audit", "summary": "get audit", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "audit:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } }, { "name": "event", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "resourceId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "actorId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/get_audit_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/usage/summary": { "get": { "operationId": "get_usage_summary", "summary": "get usage summary", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "usage:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_usage_summary_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/execution-logs": { "get": { "operationId": "list_execution_logs", "summary": "list execution logs", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "audit:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] } }, { "name": "app", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "endUserId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pending", "running", "succeeded", "denied", "failed", "outcome_unknown", "awaiting_approval" ] } }, { "name": "action", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } }, { "name": "limit", "in": "query", "required": false, "schema": { "default": 100, "type": "integer", "minimum": 1, "maximum": 100 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_execution_logs_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/execution-logs/{id}": { "get": { "operationId": "get_execution_log", "summary": "get execution log", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "audit:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_execution_log_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/usage": { "get": { "operationId": "get_usage", "summary": "get usage", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "usage:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/get_usage_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys": { "get": { "operationId": "list_api_keys", "summary": "list api keys", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "keys:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 4096 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "nextCursor" ], "properties": { "data": { "$ref": "#/components/schemas/list_api_keys_output" }, "nextCursor": { "type": [ "string", "null" ] } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "create_api_key", "summary": "create api key", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "keys:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "permissions": { "minItems": 1, "maxItems": 28, "type": "array", "items": { "type": "string", "enum": [ "execute", "connect:create", "connect:group", "users:read", "users:manage", "connections:read", "connections:manage", "apps:read", "apps:manage", "auth_configs:read", "auth_configs:manage", "connect_settings:read", "connect_settings:manage", "embedded:manage", "policies:read", "policies:manage", "approvals:read", "approvals:decide", "audit:read", "usage:read", "funded_access:read", "funded_access:manage", "events:manage", "sources:manage", "keys:manage", "mcp:link", "mcp:keys", "connect" ] } }, "preset": { "type": "string", "enum": [ "runtime", "integration", "read_only", "full_access" ] }, "expiresIn": { "type": "integer", "minimum": 60, "maximum": 31536000 } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_api_key_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/{id}/rotate": { "post": { "operationId": "rotate_api_key", "summary": "rotate api key", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "keys:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } }, { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "overlapHours": { "default": 24, "type": "number", "minimum": 0, "maximum": 168 } }, "required": [], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/rotate_api_key_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/keys/{id}": { "delete": { "operationId": "revoke_api_key", "summary": "revoke api key", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "keys:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 256 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/revoke_api_key_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/connect-sessions": { "post": { "operationId": "create_connect_session", "summary": "Create a short-lived hosted Arc0 Connect session for an existing end user. Returns a short-lived bearer capability URL with its token in the fragment, not provider credentials. Hand this link straight to the intended end user; never browse/fetch it, log it, commit it, or use it as agent authorization. Register return origins first when supplying a return URL.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect:create" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endUserId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "externalUserId": { "type": "string", "minLength": 1, "maxLength": 200 }, "apps": { "minItems": 1, "maxItems": 500, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "catalogFilter": { "type": "object", "properties": { "authMethods": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "oauth", "api_key", "basic", "two_step" ] } } }, "required": [ "authMethods" ], "additionalProperties": false }, "authMethod": { "type": "string", "enum": [ "oauth", "api_key", "basic", "two_step" ] }, "reconnectConnectionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "returnUrl": { "type": "string", "maxLength": 2000 }, "state": { "type": "string", "maxLength": 1000 }, "expiresInSeconds": { "default": 600, "type": "integer", "minimum": 60, "maximum": 600 } }, "additionalProperties": false, "required": [] } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_connect_session_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/catalog": { "get": { "operationId": "search_catalog_apps", "summary": "Search the supported app catalog by name or ID. Returns up to 50 matches; enabling an app is a separate operation.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "query", "in": "query", "required": false, "schema": { "default": "", "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/search_catalog_apps_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/embedded-origins": { "put": { "operationId": "register_embedded_origins", "summary": "Replace the complete allowed browser-origin list for embedded management. Supply exact origins, at most 20; Production requires HTTPS. Existing origins omitted here are removed.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "embedded:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "origins": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 256 } } }, "required": [ "origins" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/register_embedded_origins_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/return-origins": { "put": { "operationId": "register_return_origins", "summary": "Replace the complete allowed return-origin list for hosted Connect sessions. Supply exact origins, at most 20; Production requires HTTPS. Existing origins omitted here are removed.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "connect_settings:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "origins": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 256 } } }, "required": [ "origins" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/register_return_origins_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/webhooks": { "post": { "operationId": "create_webhook_endpoint", "summary": "Create an organization-owned HTTPS webhook endpoint. The signing secret is available only through the console; use send_test_event and get_webhook_test to verify delivery.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "url": { "type": "string", "maxLength": 2000, "format": "uri" } }, "required": [ "name", "url" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/create_webhook_endpoint_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/webhook-tests": { "post": { "operationId": "send_test_event", "summary": "Queue one signed arc0.test webhook probe for an enabled organization-owned endpoint. One outstanding probe per project and at most one per minute per endpoint are allowed. Delivery is asynchronous; poll get_webhook_test.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endpointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "endpointId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/send_test_event_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/webhook-tests/{id}": { "get": { "operationId": "get_webhook_test", "summary": "Read the pending, sending, delivered or failed state and HTTP status of a queued webhook probe. An uncertain sending state does not prove receipt and is never retried automatically.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_webhook_test_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/setup-status": { "get": { "operationId": "get_setup_status", "summary": "Inspect project setup readiness: keys, apps, branding, origins, webhooks and a delivered probe, BYO OAuth, and signing configuration. Returns booleans only; Development readiness does not prove Production/provider acceptance.", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "apps:read", "connect_settings:read", "auth_configs:read" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_setup_status_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/project-webhooks": { "get": { "operationId": "get_project_webhook", "summary": "get project webhook", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/get_project_webhook_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "save_project_webhook", "summary": "save project webhook", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "maxLength": 2000 }, "events": { "maxItems": 4, "type": "array", "items": { "type": "string", "enum": [ "connection.activated", "connection.failed", "execution.failed", "approval.requested" ] } }, "enabled": { "type": "boolean" } }, "required": [ "url", "events", "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/save_project_webhook_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/project-webhooks/test": { "post": { "operationId": "test_project_webhook", "summary": "test project webhook", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "proposal", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/test_project_webhook_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/management/project-webhooks/deliveries": { "get": { "operationId": "list_project_webhook_deliveries", "summary": "list project webhook deliveries", "tags": [ "Management" ], "security": [ { "apiKey": [] }, { "bearerKey": [] } ], "x-arc0-scopes": [ "events:manage" ], "x-arc0-audience": "business", "x-arc0-mcp": "read", "parameters": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/list_project_webhook_deliveries_output" } }, "additionalProperties": false } } } }, "400": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Request failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "in": "header", "name": "x-api-key" }, "bearerKey": { "type": "http", "scheme": "bearer" } }, "schemas": { "get_funded_access_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_funded_access_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "set_funded_access_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "set_funded_access_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "enabled": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false }, "get_mcp_oauth_settings_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_mcp_oauth_settings_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "clients": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app": { "type": "string" }, "issuer": { "type": "string" }, "created_at": { "type": "string" }, "retired_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "supersedes_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "selected": { "type": "boolean" } }, "required": [ "id", "app", "issuer", "created_at", "retired_at", "supersedes_id", "selected" ], "additionalProperties": false } }, "branding": { "anyOf": [ { "type": "object", "properties": { "client_name": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[^\\p{Cc}\\p{Cf}<>]+$" }, "logo_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "client_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "policy_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "tos_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" } }, "required": [ "client_name" ], "additionalProperties": false }, { "type": "null" } ] }, "clientId": { "type": "string" } }, "required": [ "clients", "branding", "clientId" ], "additionalProperties": false }, "create_mcp_oauth_client_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "minLength": 1, "maxLength": 100 }, "client": { "type": "object", "properties": { "issuer": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "clientId": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$", "writeOnly": true }, "authMethod": { "type": "string", "enum": [ "none", "client_secret_basic", "client_secret_post" ] }, "source": { "type": "string", "const": "byo" } }, "required": [ "issuer", "clientId", "authMethod", "source" ], "additionalProperties": false } }, "required": [ "app", "client" ], "additionalProperties": false }, "create_mcp_oauth_client_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "rotate_mcp_oauth_client_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$", "writeOnly": true }, "clientId": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" } }, "required": [ "id", "clientSecret" ], "additionalProperties": false }, "rotate_mcp_oauth_client_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "retire_mcp_oauth_client_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "id" ], "additionalProperties": false }, "retire_mcp_oauth_client_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "select_mcp_oauth_client_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "id" ], "additionalProperties": false }, "select_mcp_oauth_client_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "update_mcp_client_branding_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "client_name": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[^\\p{Cc}\\p{Cf}<>]+$" }, "logo_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "client_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "policy_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" }, "tos_uri": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n\\u0000]+$" } }, "required": [ "client_name" ], "additionalProperties": false }, "update_mcp_client_branding_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "clientId": { "type": "string" } }, "required": [ "clientId" ], "additionalProperties": false }, "create_auth_config_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "clientId": { "type": "string", "minLength": 1, "maxLength": 300 }, "clientSecret": { "type": "string", "minLength": 1, "maxLength": 4000, "writeOnly": true } }, "required": [ "app", "name", "clientId", "clientSecret" ], "additionalProperties": false }, "create_auth_config_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app": { "type": "string", "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "clientId": { "type": "string" } }, "required": [ "id", "app", "name", "clientId" ], "additionalProperties": false }, "disable_auth_config_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "disable_auth_config_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "get_approval_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "approvalId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "approvalId" ], "additionalProperties": false }, "get_approval_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "executionId": { "type": "string", "minLength": 1, "maxLength": 256 }, "endUserId": { "type": "string", "minLength": 1, "maxLength": 256 }, "action": { "type": "string" }, "actionVersion": { "type": "string" }, "sourceId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "sourceRevision": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "accessSource": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "connectionId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "serviceAccountId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "offerId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "policyRevision": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "expiresAt": { "type": "string" }, "request": { "$ref": "#/components/schemas/get_approval_output/$defs/__schema0" } }, "required": [ "id", "executionId", "endUserId", "action", "actionVersion", "sourceId", "sourceRevision", "accessSource", "connectionId", "serviceAccountId", "offerId", "policyRevision", "expiresAt", "request" ], "additionalProperties": false, "$defs": { "__schema0": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/get_approval_output/$defs/__schema0" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/get_approval_output/$defs/__schema0" } } ] } } }, "decide_approval_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "approvalId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "decision": { "type": "string", "enum": [ "approve", "deny" ] } }, "required": [ "approvalId", "decision" ], "additionalProperties": false }, "decide_approval_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true }, "executionId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "ok", "executionId" ], "additionalProperties": false }, "get_connect_settings_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_connect_settings_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "effectiveBranding": { "type": "object", "properties": { "displayName": { "type": "string" }, "logoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "supportUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "theme": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "light", "dark", "system" ] }, "radius": { "type": "integer", "minimum": 0, "maximum": 24 }, "light": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false }, "dark": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false } }, "required": [ "mode", "radius", "light", "dark" ], "additionalProperties": false }, "showPoweredBy": { "type": "boolean" }, "canHidePoweredBy": { "type": "boolean" } }, "required": [ "displayName", "logoUrl", "supportUrl", "theme", "showPoweredBy", "canHidePoweredBy" ], "additionalProperties": false }, "branding": { "anyOf": [ { "type": "object", "properties": { "organization_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "project_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "updated_at": { "type": "string" }, "display_name": { "type": "string" }, "accent_color": { "type": "string" }, "logo_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "support_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "theme": { "anyOf": [ { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "light", "dark", "system" ] }, "radius": { "type": "integer", "minimum": 0, "maximum": 24 }, "light": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false }, "dark": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false } }, "required": [ "mode", "radius", "light", "dark" ], "additionalProperties": false }, { "type": "object", "properties": {}, "additionalProperties": false } ] }, "hide_arc0_badge": { "type": "boolean" } }, "required": [ "organization_id", "project_id", "updated_at", "display_name", "accent_color", "logo_url", "support_url", "theme", "hide_arc0_badge" ], "additionalProperties": false }, { "type": "null" } ] }, "domains": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "hostname": { "type": "string" }, "verification_token": { "type": "string" }, "status": { "type": "string" }, "verified_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "custom_hostname_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] } }, "required": [ "id", "hostname", "verification_token", "status", "verified_at", "custom_hostname_id" ], "additionalProperties": false } } }, "required": [ "effectiveBranding", "branding", "domains" ], "additionalProperties": false }, "update_connect_branding_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "displayName": { "type": "string", "minLength": 1, "maxLength": 100 }, "accentColor": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "logoUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "supportUrl": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "theme": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "light", "dark", "system" ] }, "radius": { "type": "integer", "minimum": 0, "maximum": 24 }, "light": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false }, "dark": { "type": "object", "properties": { "background": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "foreground": { "type": "string", "pattern": "^#[a-f\\d]{6}$" }, "accent": { "type": "string", "pattern": "^#[a-f\\d]{6}$" } }, "required": [ "background", "foreground", "accent" ], "additionalProperties": false } }, "required": [ "mode", "radius", "light", "dark" ], "additionalProperties": false }, "hideArc0Badge": { "type": "boolean" } }, "required": [ "displayName", "accentColor" ], "additionalProperties": false }, "update_connect_branding_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "create_connect_domain_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "hostname": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z]{2,63}$" } }, "required": [ "hostname" ], "additionalProperties": false }, "create_connect_domain_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "hostname": { "type": "string" }, "record": { "type": "string" }, "value": { "type": "string" }, "status": { "type": "string", "const": "pending" } }, "required": [ "id", "hostname", "record", "value", "status" ], "additionalProperties": false }, "verify_connect_domain_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "domainId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "domainId" ], "additionalProperties": false }, "verify_connect_domain_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "verified" }, "activationRequired": { "type": "boolean", "const": true } }, "required": [ "status", "activationRequired" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "active" }, "activationRequired": { "type": "boolean", "const": false } }, "required": [ "status", "activationRequired" ], "additionalProperties": false } ] }, "list_projects_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_projects_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "organization_id": { "type": "string" }, "name": { "type": "string" }, "slug": { "type": "string" }, "environment": { "type": "string", "enum": [ "production", "development" ] }, "production_project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "id", "organization_id", "name", "slug", "environment", "production_project_id", "status", "created_at" ], "additionalProperties": false } }, "list_end_users_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 }, "health": { "type": "string", "enum": [ "active", "expired", "failed", "inactive" ] } }, "additionalProperties": false }, "list_end_users_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "active_connections": { "type": "number" }, "expired_connections": { "type": "number" }, "failed_connections": { "type": "number" }, "inactive_connections": { "type": "number" }, "last_activity_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "external_id": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "id", "external_id", "name", "status", "created_at" ], "additionalProperties": false } }, "get_end_user_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endUserId": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } }, "required": [ "endUserId" ], "additionalProperties": false }, "get_end_user_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "active_connections": { "type": "number" }, "expired_connections": { "type": "number" }, "failed_connections": { "type": "number" }, "inactive_connections": { "type": "number" }, "last_activity_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "external_id": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "id", "external_id", "name", "status", "created_at" ], "additionalProperties": false }, "create_end_user_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "externalId": { "type": "string", "minLength": 1, "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "externalId", "name" ], "additionalProperties": false }, "create_end_user_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "set_end_user_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "enabled": { "type": "boolean" } }, "required": [ "id", "enabled" ], "additionalProperties": false }, "set_end_user_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "list_groups_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_groups_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "external_id": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "disabled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" } }, "required": [ "id", "external_id", "name", "disabled_at", "created_at" ], "additionalProperties": false } }, "create_group_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "externalId": { "type": "string", "minLength": 1, "maxLength": 100 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "externalId", "name" ], "additionalProperties": false }, "create_group_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "set_group_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "enabled": { "type": "boolean" } }, "required": [ "id", "enabled" ], "additionalProperties": false }, "set_group_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "list_group_memberships_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_group_memberships_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "group_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "end_user_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "revoked_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "user_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "group_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "group_id", "end_user_id", "revoked_at", "user_name", "group_name" ], "additionalProperties": false } }, "add_group_member_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "groupId": { "type": "string", "minLength": 1, "maxLength": 256 }, "endUserId": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } }, "required": [ "groupId", "endUserId" ], "additionalProperties": false }, "add_group_member_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "remove_group_member_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "groupId": { "type": "string", "minLength": 1, "maxLength": 256 }, "endUserId": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" } }, "required": [ "groupId", "endUserId" ], "additionalProperties": false }, "remove_group_member_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "list_project_connections_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_project_connections_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app": { "type": "string" }, "display_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "healthStatus": { "type": "string" }, "auth_method": { "type": "string" }, "auth_lane": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "end_user_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "group_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "scopes": { "type": "array", "items": { "type": "string" } }, "created_at": { "type": "string" }, "connection_config": { "$ref": "#/components/schemas/list_project_connections_output/$defs/__schema0" }, "provider_revocation_unconfirmed": { "type": "boolean" } }, "required": [ "id", "app", "display_name", "status", "healthStatus", "auth_method", "auth_lane", "end_user_id", "group_id", "scopes", "created_at", "connection_config", "provider_revocation_unconfirmed" ], "additionalProperties": false }, "$defs": { "__schema0": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/list_project_connections_output/$defs/__schema0" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/list_project_connections_output/$defs/__schema0" } } ] } } }, "list_project_apps_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_project_apps_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app": { "type": "string" }, "enabled": { "type": "boolean" }, "auth_config_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "app", "enabled", "auth_config_id" ], "additionalProperties": false } }, "enable_app_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "maxLength": 100 } }, "required": [ "app" ], "additionalProperties": false }, "enable_app_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "list_tools_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_tools_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app_id": { "type": "string" }, "name": { "type": "string" }, "app_name": { "type": "string" }, "risk": { "type": "string", "enum": [ "read", "write", "destructive" ] }, "version": { "type": "string" }, "selected_version": { "type": "string" }, "version_pinned": { "type": "boolean" }, "enabled": { "type": "boolean" }, "app_enabled": { "type": "boolean" }, "access_sources": { "type": "array", "items": { "type": "string" } }, "access_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "input_schema": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema0" }, "output_schema": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema1" }, "service_account_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "offer_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "action": { "type": "string" }, "enabled": { "type": "boolean" }, "readiness": { "type": "string" }, "price_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] }, "currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "customer_unit_micros": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, { "type": "null" } ] } }, "required": [ "id", "action", "enabled", "readiness", "price_id", "currency", "unit", "customer_unit_micros" ], "additionalProperties": false } } }, "required": [ "id", "app_id", "name", "app_name", "risk", "version", "selected_version", "version_pinned", "enabled", "app_enabled", "access_sources", "access_source", "service_account_id", "offer_id", "offers" ], "additionalProperties": false }, "$defs": { "__schema0": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema0" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema0" } } ] }, "__schema1": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema1" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/list_tools_output/$defs/__schema1" } } ] } } }, "configure_tool_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "action": { "type": "string", "minLength": 1, "maxLength": 256 }, "enabled": { "type": "boolean" }, "source": { "type": "string", "enum": [ "connection", "service_account", "platform", "public" ] }, "serviceAccountId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "offerId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "action", "enabled", "source" ], "additionalProperties": false }, "configure_tool_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "pin_tool_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "action": { "type": "string", "minLength": 1, "maxLength": 256 }, "version": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "action", "version" ], "additionalProperties": false }, "pin_tool_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "action": { "type": "string", "minLength": 1, "maxLength": 256 }, "version": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "action", "version" ], "additionalProperties": false }, "list_auth_configs_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_auth_configs_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "app": { "type": "string" }, "name": { "type": "string" }, "client_id": { "type": "string" }, "created_at": { "type": "string" }, "disabled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "selected": { "type": "boolean" } }, "required": [ "id", "app", "name", "client_id", "created_at", "disabled_at", "selected" ], "additionalProperties": false } }, "select_auth_config_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "app": { "type": "string", "maxLength": 100 }, "authConfigId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] } }, "required": [ "app", "authConfigId" ], "additionalProperties": false }, "select_auth_config_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "get_policy_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_policy_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rules": { "type": "object", "properties": { "read": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "write": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "destructive": { "type": "string", "enum": [ "allow", "deny", "ask" ] } }, "required": [ "read", "write", "destructive" ], "additionalProperties": false }, "revision": { "type": "number" } }, "required": [ "rules", "revision" ], "additionalProperties": false }, "update_policy_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "read": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "write": { "type": "string", "enum": [ "allow", "deny", "ask" ] }, "destructive": { "type": "string", "enum": [ "allow", "deny", "ask" ] } }, "required": [ "read", "write", "destructive" ], "additionalProperties": false }, "update_policy_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "list_approvals_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_approvals_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "execution_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "status": { "type": "string" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "decided_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "action": { "type": "string" }, "action_version": { "type": "string" }, "end_user_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "access_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "connection_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 256 }, { "type": "null" } ] } }, "required": [ "id", "execution_id", "status", "created_at", "expires_at", "decided_at", "action", "action_version", "end_user_id", "access_source", "connection_id" ], "additionalProperties": false } }, "get_audit_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 }, "event": { "type": "string", "minLength": 1, "maxLength": 256 }, "resourceId": { "type": "string", "minLength": 1, "maxLength": 256 }, "actorId": { "type": "string", "minLength": 1, "maxLength": 256 } }, "additionalProperties": false }, "get_audit_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "actor_id": { "type": "string" }, "event": { "type": "string" }, "resource_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "metadata": { "$ref": "#/components/schemas/get_audit_output/$defs/__schema0" }, "created_at": { "type": "string" } }, "required": [ "id", "actor_id", "event", "resource_id", "metadata", "created_at" ], "additionalProperties": false }, "$defs": { "__schema0": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" }, { "type": "array", "items": { "$ref": "#/components/schemas/get_audit_output/$defs/__schema0" } }, { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "$ref": "#/components/schemas/get_audit_output/$defs/__schema0" } } ] } } }, "get_usage_summary_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "range": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] } }, "additionalProperties": false }, "get_usage_summary_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "range": { "type": "string", "enum": [ "7d", "30d", "90d" ] }, "startAt": { "type": "string" }, "endAt": { "type": "string" }, "toolCalls": { "type": "number" }, "errorCount": { "type": "number" }, "errorRate": { "type": "number" }, "activeEndUsers": { "type": "number" }, "fundedSpendMicros": { "type": "string" }, "currency": { "type": "string", "const": "USD" }, "daily": { "type": "array", "items": { "type": "object", "properties": { "date": { "type": "string" }, "toolCalls": { "type": "number" } }, "required": [ "date", "toolCalls" ], "additionalProperties": false } }, "topApps": { "type": "array", "items": { "type": "object", "properties": { "app": { "type": "string" }, "toolCalls": { "type": "number" }, "errorCount": { "type": "number" } }, "required": [ "app", "toolCalls", "errorCount" ], "additionalProperties": false } }, "topEndUsers": { "type": "array", "items": { "type": "object", "properties": { "endUserId": { "type": "string" }, "externalId": { "type": "string" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "toolCalls": { "type": "number" }, "errorCount": { "type": "number" } }, "required": [ "endUserId", "externalId", "name", "toolCalls", "errorCount" ], "additionalProperties": false } } }, "required": [ "range", "startAt", "endAt", "toolCalls", "errorCount", "errorRate", "activeEndUsers", "fundedSpendMicros", "currency", "daily", "topApps", "topEndUsers" ], "additionalProperties": false }, "list_execution_logs_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "range": { "default": "30d", "type": "string", "enum": [ "7d", "30d", "90d" ] }, "app": { "type": "string", "minLength": 1, "maxLength": 256 }, "endUserId": { "type": "string", "minLength": 1, "maxLength": 256, "description": "Internal end-user ID or external: in this project" }, "status": { "type": "string", "enum": [ "pending", "running", "succeeded", "denied", "failed", "outcome_unknown", "awaiting_approval" ] }, "action": { "type": "string", "minLength": 1, "maxLength": 256 }, "cursor": { "type": "string", "maxLength": 4096 }, "limit": { "default": 100, "type": "integer", "minimum": 1, "maximum": 100 } }, "additionalProperties": false }, "list_execution_logs_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "project_id": { "type": "string" }, "end_user_id": { "type": "string" }, "app": { "type": "string" }, "action": { "type": "string" }, "action_version": { "type": "string" }, "status": { "type": "string" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "started_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "finished_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "duration_ms": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "access_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provenance": { "type": "string" } }, "required": [ "id", "project_id", "end_user_id", "app", "action", "action_version", "status", "error_code", "created_at", "started_at", "finished_at", "duration_ms", "access_source", "provenance" ], "additionalProperties": false } }, "get_execution_log_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "get_execution_log_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "project_id": { "type": "string" }, "end_user_id": { "type": "string" }, "app": { "type": "string" }, "action": { "type": "string" }, "action_version": { "type": "string" }, "status": { "type": "string" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" }, "started_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "finished_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "duration_ms": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "access_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provenance": { "type": "string" } }, "required": [ "id", "project_id", "end_user_id", "app", "action", "action_version", "status", "error_code", "created_at", "started_at", "finished_at", "duration_ms", "access_source", "provenance" ], "additionalProperties": false }, "get_usage_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "get_usage_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "execution_id": { "type": "string", "minLength": 1, "maxLength": 256 }, "action": { "type": "string" }, "access_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unit": { "type": "string" }, "quantity": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "currency": { "type": "string" }, "customer_charge_micros": { "anyOf": [ { "type": "string" }, { "type": "number" } ] }, "state": { "type": "string" }, "created_at": { "type": "string" } }, "required": [ "id", "execution_id", "action", "access_source", "unit", "quantity", "currency", "customer_charge_micros", "state", "created_at" ], "additionalProperties": false } }, "list_api_keys_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "limit": { "default": 50, "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 } }, "additionalProperties": false }, "list_api_keys_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "disabled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "permissions": { "type": "array", "items": { "type": "string" } }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "start": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "config_id": { "type": "string" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "created_at": { "type": "string" } }, "required": [ "id", "disabled_at", "permissions", "created_by", "name", "start", "config_id", "expires_at", "created_at" ], "additionalProperties": false } }, "create_api_key_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "permissions": { "minItems": 1, "maxItems": 28, "type": "array", "items": { "type": "string", "enum": [ "execute", "connect:create", "connect:group", "users:read", "users:manage", "connections:read", "connections:manage", "apps:read", "apps:manage", "auth_configs:read", "auth_configs:manage", "connect_settings:read", "connect_settings:manage", "embedded:manage", "policies:read", "policies:manage", "approvals:read", "approvals:decide", "audit:read", "usage:read", "funded_access:read", "funded_access:manage", "events:manage", "sources:manage", "keys:manage", "mcp:link", "mcp:keys", "connect" ] } }, "preset": { "type": "string", "enum": [ "runtime", "integration", "read_only", "full_access" ] }, "expiresIn": { "type": "integer", "minimum": 60, "maximum": 31536000 } }, "required": [ "name" ], "additionalProperties": false }, "create_api_key_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "key": { "type": "string" }, "configId": { "type": "string" } }, "required": [ "id", "key", "configId" ], "additionalProperties": false }, "rotate_api_key_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "overlapHours": { "default": 24, "type": "number", "minimum": 0, "maximum": 168 } }, "required": [ "id" ], "additionalProperties": false }, "rotate_api_key_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 }, "key": { "type": "string" }, "configId": { "type": "string" } }, "required": [ "id", "key", "configId" ], "additionalProperties": false }, "revoke_api_key_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 256 } }, "required": [ "id" ], "additionalProperties": false }, "revoke_api_key_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "create_connect_session_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endUserId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "externalUserId": { "type": "string", "minLength": 1, "maxLength": 200 }, "apps": { "minItems": 1, "maxItems": 500, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "catalogFilter": { "type": "object", "properties": { "authMethods": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "oauth", "api_key", "basic", "two_step" ] } } }, "required": [ "authMethods" ], "additionalProperties": false }, "authMethod": { "type": "string", "enum": [ "oauth", "api_key", "basic", "two_step" ] }, "reconnectConnectionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "returnUrl": { "type": "string", "maxLength": 2000 }, "state": { "type": "string", "maxLength": 1000 }, "expiresInSeconds": { "default": 600, "type": "integer", "minimum": 60, "maximum": 600 } }, "additionalProperties": false }, "create_connect_session_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "expiresAt": { "type": "string" } }, "required": [ "id", "url", "expiresAt" ], "additionalProperties": false }, "search_catalog_apps_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "query": { "default": "", "type": "string", "maxLength": 200 } }, "additionalProperties": false }, "search_catalog_apps_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false } }, "register_embedded_origins_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "origins": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 256 } } }, "required": [ "origins" ], "additionalProperties": false }, "register_embedded_origins_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "register_return_origins_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "origins": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 256 } } }, "required": [ "origins" ], "additionalProperties": false }, "register_return_origins_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean", "const": true } }, "required": [ "ok" ], "additionalProperties": false }, "create_webhook_endpoint_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "url": { "type": "string", "maxLength": 2000, "format": "uri" } }, "required": [ "name", "url" ], "additionalProperties": false }, "create_webhook_endpoint_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" }, "enabled": { "type": "boolean" }, "consolePath": { "type": "string" } }, "required": [ "id", "name", "url", "enabled", "consolePath" ], "additionalProperties": false }, "send_test_event_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "endpointId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "endpointId" ], "additionalProperties": false }, "send_test_event_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string", "const": "pending" } }, "required": [ "id", "state" ], "additionalProperties": false }, "get_webhook_test_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "id" ], "additionalProperties": false }, "get_webhook_test_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "state": { "type": "string" }, "status_code": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "id", "state", "status_code" ], "additionalProperties": false }, "get_setup_status_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_setup_status_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "environment": { "type": "string" }, "ready": { "type": "boolean" }, "checks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "ready": { "type": "boolean" }, "required": { "type": "boolean" } }, "required": [ "id", "ready", "required" ], "additionalProperties": false } } }, "required": [ "environment", "ready", "checks" ], "additionalProperties": false }, "get_project_webhook_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "get_project_webhook_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "enabled": { "type": "boolean" }, "signing_version": { "type": "number" }, "created_at": { "type": "string" }, "dropped_count": { "type": "string" }, "last_dropped_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "url", "events", "enabled", "signing_version", "created_at", "dropped_count", "last_dropped_at" ], "additionalProperties": false }, { "type": "null" } ] }, "save_project_webhook_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "url": { "type": "string", "maxLength": 2000 }, "events": { "maxItems": 4, "type": "array", "items": { "type": "string", "enum": [ "connection.activated", "connection.failed", "execution.failed", "approval.requested" ] } }, "enabled": { "type": "boolean" } }, "required": [ "url", "events", "enabled" ], "additionalProperties": false }, "save_project_webhook_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" }, "signingVersion": { "type": "number" } }, "required": [ "id", "signingVersion" ], "additionalProperties": false }, "test_project_webhook_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "test_project_webhook_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false }, "list_project_webhook_deliveries_input": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "list_project_webhook_deliveries_output": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "resource_id": { "type": "string" }, "occurred_at": { "type": "string" }, "state": { "type": "string" }, "attempts": { "type": "number" }, "status_code": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "next_attempt_at": { "type": "string" }, "delivered_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "type", "resource_id", "occurred_at", "state", "attempts", "status_code", "next_attempt_at", "delivered_at" ], "additionalProperties": false } }, "Error": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }