{ "components": { "schemas": { "ProblemDetails": { "additionalProperties": true, "properties": { "detail": { "type": "string" }, "error_code": { "type": "string" }, "impact": { "type": "string" }, "request_id": { "type": "string" }, "status": { "type": "integer" }, "suggested_action": { "type": "string" }, "title": { "type": "string" }, "trace_id": { "type": "string" }, "type": { "type": "string" } }, "required": ["type", "title", "status", "detail", "error_code"], "type": "object" } }, "securitySchemes": { "apiKeyAuth": { "in": "header", "name": "X-API-Key", "type": "apiKey" }, "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "Every customer operation is resource-addressed. Team resources use /api/v1/t/{team}/... and App resources use /api/v1/t/{team}/a/{app}/.... The {team} and {app} path segments select the resource; session, X-API-Key, and delegated bearer credentials authorize access to that addressed resource.", "title": "synsmarts control-plane API", "version": "v1" }, "openapi": "3.1.0", "paths": { "/api/v1/t/{team}/a/{app}/audit-events": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "audit.getEvents", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 512, "type": "string" } }, { "in": "query", "name": "end", "required": false, "schema": { "format": "date-time", "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "start", "required": false, "schema": { "format": "date-time", "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Audit events", "tags": ["audit"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["audit.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Audit events", "presented": true } } }, "/api/v1/t/{team}/a/{app}/backups": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "backups.list", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Backups", "tags": ["backups"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["backups.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Backups", "presented": true } } }, "/api/v1/t/{team}/a/{app}/config/preview": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Analysis-only; leaves App configuration unchanged.", "operationId": "control.previewConfiguration", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" }, "config": { "additionalProperties": true, "type": "object" } }, "required": ["app_id", "config"], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "changed": { "type": "boolean" }, "committed": { "const": false, "type": "boolean" }, "current_revision_token": { "type": "string" }, "effective_diff": { "items": { "type": "string" }, "type": "array" }, "required_confirmation": { "type": "boolean" }, "side_effect_class": { "type": "string" }, "valid": { "type": "boolean" } }, "required": [ "valid", "changed", "effective_diff", "side_effect_class", "required_confirmation", "current_revision_token", "committed" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Preview configuration", "tags": ["control"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "analysis", "x-synsmarts-ui": { "label": "Preview configuration", "presented": true } } }, "/api/v1/t/{team}/a/{app}/config/reconcile": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.reconcileConfiguration", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" }, "confirmed": { "const": true, "type": "boolean" }, "force": { "default": false, "type": "boolean" } }, "required": ["app_id", "confirmed"], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deployment_id": { "type": "string" }, "head_sha": { "type": "string" }, "last_applied_sha": { "type": "string" }, "status": { "enum": ["synced", "no_change"], "type": "string" } }, "required": ["status", "head_sha"], "type": "object" } } }, "description": "Already synchronized" }, "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deployment_id": { "type": "string" }, "head_sha": { "type": "string" }, "last_applied_sha": { "type": "string" }, "status": { "const": "queued", "type": "string" } }, "required": ["status", "head_sha", "deployment_id"], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "405": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Method not allowed" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unprocessable entity" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Reapply committed configuration", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "deployment_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": "deploy config-reconcile", "presented": true }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["config.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Reapply committed configuration", "presented": false } } }, "/api/v1/t/{team}/a/{app}/config/rollback": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.rollbackConfiguration", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" }, "confirmed": { "const": true, "type": "boolean" }, "revision_token": { "minLength": 1, "type": "string" }, "target_ref": { "minLength": 1, "type": "string" } }, "required": [ "app_id", "confirmed", "revision_token", "target_ref" ], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "config_commit_sha": { "type": "string" }, "operation_id": { "type": "string" }, "status": { "enum": ["dispatched", "committed"], "type": "string" } }, "required": ["status", "operation_id", "config_commit_sha"], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Roll back configuration", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "operation_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["config.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": true }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Roll back configuration", "presented": true } } }, "/api/v1/t/{team}/a/{app}/config/validate": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Analysis-only; leaves App configuration unchanged.", "operationId": "control.validateConfiguration", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" }, "config": { "additionalProperties": true, "type": "object" } }, "required": ["app_id", "config"], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "changed": { "type": "boolean" }, "committed": { "const": false, "type": "boolean" }, "current_revision_token": { "type": "string" }, "effective_diff": { "items": { "type": "string" }, "type": "array" }, "required_confirmation": { "type": "boolean" }, "side_effect_class": { "type": "string" }, "valid": { "type": "boolean" } }, "required": [ "valid", "changed", "effective_diff", "side_effect_class", "required_confirmation", "current_revision_token", "committed" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Validate configuration", "tags": ["control"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "analysis", "x-synsmarts-ui": { "label": "Validate configuration", "presented": true } } }, "/api/v1/t/{team}/a/{app}/deploys": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.getDeployHistory", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "environment", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "finding_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 50, "minimum": 1, "type": "integer" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "additionalProperties": false, "properties": { "created_at": {}, "data_impact_assessment": {}, "deploy_id": { "type": "string" }, "deploy_path": {}, "deploy_phase": {}, "environment": {}, "failure_reason": {}, "failure_stage": {}, "id": {}, "image_digest": {}, "rollback_eligible": {}, "rollback_ineligible_reason": {}, "rollback_of": {}, "rollback_resolution": {}, "source_hash": {}, "source_ref": {}, "source_type": {}, "stage_timestamps": {}, "tenant_id": {}, "trigger_actor_label": {}, "trigger_actor_type": {}, "trigger_type": {}, "updated_at": {}, "warnings": { "items": { "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Deployment history", "tags": ["deployment"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["deployments.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Deployment history", "presented": true } } }, "/api/v1/t/{team}/a/{app}/deploys/create": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "deployment.deploy", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "environment": { "type": "string" }, "source_hash": { "type": "string" }, "source_ref": { "maxLength": 255, "minLength": 1, "type": "string" }, "source_type": { "enum": ["git", "workspace"], "type": "string" } }, "required": [ "confirmed", "environment", "source_ref", "source_type" ], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deploy_id": { "type": "string" }, "deployment_id": { "type": "string" }, "source_type": { "enum": ["git", "workspace"], "type": "string" }, "status": { "const": "pending", "type": "string" }, "warnings": { "items": { "type": "object" }, "type": "array" } }, "required": [ "deployment_id", "deploy_id", "status", "source_type" ], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Deploy", "tags": ["deployment"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "deploy_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["deployments.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Deploy", "presented": true } } }, "/api/v1/t/{team}/a/{app}/deploys/{deploy_id}": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "deployment.getStatus", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "deploy_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "created_at": {}, "data_impact_assessment": {}, "deploy_id": { "type": "string" }, "deploy_path": {}, "deploy_phase": {}, "environment": {}, "failure_reason": {}, "failure_stage": {}, "id": {}, "image_digest": {}, "rollback_eligible": {}, "rollback_ineligible_reason": {}, "rollback_of": {}, "rollback_resolution": {}, "source_hash": {}, "source_ref": {}, "source_type": {}, "stage_timestamps": {}, "tenant_id": {}, "trigger_actor_label": {}, "trigger_actor_type": {}, "trigger_type": {}, "updated_at": {}, "warnings": { "items": { "type": "object" }, "type": "array" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Deployment status", "tags": ["deployment"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["operations.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Deployment status", "presented": true } } }, "/api/v1/t/{team}/a/{app}/deploys/{deploy_id}/rollback": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "deployment.rollback", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "deploy_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" } }, "required": ["confirmed"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deploy_id": { "type": "string" }, "deployment_id": { "type": "string" }, "status": { "type": "string" }, "workflow_id": { "type": "string" } }, "required": [ "status", "deploy_id", "deployment_id", "workflow_id" ], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Roll back deployment", "tags": ["deployment"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "deploy_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["deployments.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Roll back deployment", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.listInvestigations", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "description": "Page size. Invalid values default to 20; values below 1 clamp to 1 and values above 100 clamp to 100.", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "description": "Zero-based offset. Invalid or negative values are returned as 0.", "type": "integer" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "investigations": { "items": { "additionalProperties": false, "properties": { "created_at": { "format": "date-time", "type": "string" }, "deep_progress": { "type": "integer" }, "deep_state": { "enum": ["none", "running", "complete", "failed"], "type": "string" }, "description": { "type": "string" }, "investigation_id": { "type": "string" }, "partial_results": { "items": {}, "type": "array" }, "phase": { "type": "string" }, "progress": { "type": "integer" }, "status": { "enum": [ "queued", "running", "completed", "failed" ], "type": "string" }, "tenant_id": { "type": "string" }, "trigger_type": { "enum": ["manual", "detection"], "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "investigation_id", "tenant_id", "status", "phase", "progress", "partial_results", "deep_state", "deep_progress", "trigger_type", "description", "created_at", "updated_at" ], "type": "object" }, "type": "array" }, "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "minimum": 0, "type": "integer" }, "total": { "minimum": 0, "type": "integer" } }, "required": ["investigations", "total", "offset", "limit"], "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Diagnostic investigations", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["findings.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Diagnostic investigations", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/code/search": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.searchCode", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "file_path_filter", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "finding_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "query", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "query", "name": "query_type", "required": false, "schema": { "default": "regex", "enum": ["literal", "regex"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Search code", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["code.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Search code", "presented": false } } }, "/api/v1/t/{team}/a/{app}/diagnostics/config/{service}": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.getConfig", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "service", "required": true, "schema": { "enum": ["php", "mysql", "redis", "nginx"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Get configuration", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Get configuration", "presented": false } } }, "/api/v1/t/{team}/a/{app}/diagnostics/explain": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Analysis-only; leaves App configuration unchanged.", "operationId": "diagnostics.explainQuery", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "query": { "minLength": 1, "type": "string" } }, "required": ["query"], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Explain query", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["database_queries.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "analysis", "x-synsmarts-ui": { "label": "Explain query", "presented": false } } }, "/api/v1/t/{team}/a/{app}/diagnostics/logs": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.queryLogs", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "finding_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "pattern", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "severity", "required": false, "schema": { "enum": ["debug", "info", "warning", "error", "critical"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "time_range", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Query logs", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["logs.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Query logs", "presented": false } } }, "/api/v1/t/{team}/a/{app}/diagnostics/metrics": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.queryMetrics", "parameters": [ { "in": "query", "name": "aggregation", "required": false, "schema": { "enum": ["avg", "max", "min", "sum", "p95", "p99"], "type": "string" } }, { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "finding_id", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "metric_name", "required": true, "schema": { "enum": ["cpu", "memory", "request_rate"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "time_range", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Query metrics", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["metrics.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Query metrics", "presented": false } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.recommendations.list", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": {}, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Recommendations", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["findings.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Recommendations", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.recommendations.get", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": {}, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Recommendation detail", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["findings.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Recommendation detail", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}/apply": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "diagnostics.recommendations.apply", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" } }, "required": ["app_id"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "operation_id": { "type": "string" }, "operation_kind": { "const": "config_change", "type": "string" }, "status": { "const": "dispatched", "type": "string" } }, "required": ["status", "operation_id", "operation_kind"], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Apply recommendation", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "operation_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["recommendations.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "mutation", "x-synsmarts-ui": { "label": "Apply recommendation", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}/dismiss": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "diagnostics.recommendations.dismiss", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" } }, "required": ["app_id"], "type": "object" } } }, "required": true }, "responses": { "204": { "description": "Operation completed" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Dismiss recommendation", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["recommendations.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "mutation", "x-synsmarts-ui": { "label": "Dismiss recommendation", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}/mark-applied": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "diagnostics.recommendations.markApplied", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" } }, "required": ["app_id"], "type": "object" } } }, "required": true }, "responses": { "204": { "description": "Operation completed" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Mark recommendation applied", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["recommendations.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "mutation", "x-synsmarts-ui": { "label": "Mark recommendation applied", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}/mark-not-applied": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "diagnostics.recommendations.markNotApplied", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" } }, "required": ["app_id"], "type": "object" } } }, "required": true }, "responses": { "204": { "description": "Operation completed" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Mark recommendation not applied", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["recommendations.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "mutation", "x-synsmarts-ui": { "label": "Mark recommendation not applied", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/recommendations/{rec_id}/reopen": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "diagnostics.recommendations.reopen", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "rec_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" } }, "required": ["app_id"], "type": "object" } } }, "required": true }, "responses": { "204": { "description": "Operation completed" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Reopen recommendation", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["recommendations.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "mutation", "x-synsmarts-ui": { "label": "Reopen recommendation", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/traces": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.queryTraces", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "cursor", "required": false, "schema": { "maxLength": 512, "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 20, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "started_after", "required": false, "schema": { "format": "date-time", "type": "string" } }, { "in": "query", "name": "started_before", "required": false, "schema": { "format": "date-time", "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "time_range", "required": false, "schema": { "default": "1h", "pattern": "^[1-9][0-9]*[mhd]$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Trace summaries", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["traces.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Trace summaries", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/traces/{trace_id}": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.getTraceDetail", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "trace_id", "required": true, "schema": { "description": "W3C trace identifier (32 hexadecimal characters).", "pattern": "^[0-9A-Fa-f]{32}$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Trace detail", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["traces.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Trace detail", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/trigger": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Analysis-only; leaves App configuration unchanged.", "operationId": "diagnostics.triggerInvestigation", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "symptoms": { "description": "Description of the issue to diagnose.", "type": "string" } }, "type": "object" } } }, "required": false }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "investigation_id": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": ["investigation_id", "tenant_id", "status"], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Run diagnostics", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "investigation_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["diagnostics.run"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "analysis", "x-synsmarts-ui": { "label": "Run diagnostics", "presented": true } } }, "/api/v1/t/{team}/a/{app}/diagnostics/{investigation_id}/report": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "diagnostics.getReport", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "investigation_id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "completed_at": { "description": "ISO 8601 completion time, or null until the investigation completes.", "type": ["string", "null"] }, "created_at": { "format": "date-time", "type": "string" }, "findings": { "items": { "additionalProperties": false, "properties": { "category": { "type": "string" }, "code_location": { "type": "string" }, "confidence": { "maximum": 1, "minimum": 0, "type": "number" }, "created_at": { "format": "date-time", "type": "string" }, "detection_layer": { "enum": [ "threshold", "baseline", "anomaly", "cross_fleet", "deep_investigation" ], "type": "string" }, "evidence": { "additionalProperties": true, "type": "object" }, "finding_id": { "type": "string" }, "impact_assessment": { "type": "string" }, "patchable": { "type": "boolean" }, "recommendation": { "type": "string" }, "root_cause": { "type": "string" }, "rules_based": { "type": "boolean" }, "severity": { "enum": ["", "critical", "high", "medium", "low"], "type": "string" }, "status": { "enum": ["active", "resolved", "dismissed"], "type": "string" } }, "required": [ "finding_id", "detection_layer", "category", "severity", "confidence", "root_cause", "impact_assessment", "recommendation", "code_location", "evidence", "status", "patchable", "rules_based", "created_at" ], "type": "object" }, "type": "array" }, "investigation_id": { "type": "string" }, "severity": { "enum": ["", "critical", "high", "medium", "low"], "type": "string" }, "status": { "enum": ["queued", "running", "completed", "failed"], "type": "string" }, "summary": { "type": "string" }, "tenant_id": { "type": "string" } }, "required": [ "investigation_id", "tenant_id", "status", "findings", "summary", "severity", "created_at", "completed_at" ], "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Diagnostic report", "tags": ["diagnostics"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["findings.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Diagnostic report", "presented": true } } }, "/api/v1/t/{team}/a/{app}/dns": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "dnsTls.getDomains", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "DNS and TLS status", "tags": ["dnsTls"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["dns_tls.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "DNS and TLS status", "presented": true } } }, "/api/v1/t/{team}/a/{app}/environments": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "environment.list", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "type": "string" }, "type": "array" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Environments", "tags": ["environment"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["operations.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Environments", "presented": true } } }, "/api/v1/t/{team}/a/{app}/live/mysql/variables": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "live.getMysqlVariables", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "filter", "required": false, "schema": { "maxLength": 128, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "redactions_applied": { "minimum": 0, "type": "integer" }, "result": { "type": "object" }, "source": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "result", "source", "truncated", "redactions_applied" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "MySQL variables", "tags": ["live"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["status.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "MySQL variables", "presented": false } } }, "/api/v1/t/{team}/a/{app}/live/nginx/status": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "live.getNginxStatus", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "redactions_applied": { "minimum": 0, "type": "integer" }, "result": { "type": "object" }, "source": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "result", "source", "truncated", "redactions_applied" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Nginx status", "tags": ["live"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["status.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Nginx status", "presented": false } } }, "/api/v1/t/{team}/a/{app}/live/php-fpm/status": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "live.getPhpFpmStatus", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "redactions_applied": { "minimum": 0, "type": "integer" }, "result": { "type": "object" }, "source": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "result", "source", "truncated", "redactions_applied" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "PHP-FPM status", "tags": ["live"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["status.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "PHP-FPM status", "presented": false } } }, "/api/v1/t/{team}/a/{app}/live/php/info": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "live.getPhpInfo", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "redactions_applied": { "minimum": 0, "type": "integer" }, "result": { "type": "object" }, "source": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "result", "source", "truncated", "redactions_applied" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "PHP information", "tags": ["live"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["status.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "PHP information", "presented": false } } }, "/api/v1/t/{team}/a/{app}/live/redis/info": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "live.getRedisInfo", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "redis_role", "required": false, "schema": { "enum": ["cache", "session", "config-cache"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "redactions_applied": { "minimum": 0, "type": "integer" }, "result": { "type": "object" }, "source": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "result", "source", "truncated", "redactions_applied" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Redis information", "tags": ["live"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["status.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Redis information", "presented": false } } }, "/api/v1/t/{team}/a/{app}/resources": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "environment.getResources", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "app_id": { "type": "string" }, "cpu_cores": { "type": ["string", "null"] }, "memory_gib": { "type": ["string", "null"] }, "mysql_storage_gb": {}, "s3_storage_gb": {}, "workspace_storage_gb": {} }, "required": [ "app_id", "cpu_cores", "memory_gib", "mysql_storage_gb", "workspace_storage_gb", "s3_storage_gb" ], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Resources", "tags": ["environment"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Resources", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/cache/clear": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.clearCache", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "redis_role": { "enum": ["cache", "session", "config-cache"], "type": "string" } }, "required": ["confirmed"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Clear cache", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Clear cache", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/cron/disable": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.disableCron", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "enabled": { "type": "boolean" } }, "required": ["confirmed", "enabled"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Disable cron", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Disable cron", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/maintenance/toggle": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.toggleMaintenanceMode", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "enabled": { "type": "boolean" } }, "required": ["confirmed", "enabled"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "deployment_id": { "type": "string" }, "no_change": { "type": "boolean" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "revision": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Toggle maintenance mode", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Toggle maintenance mode", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/mysql/connections": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "control.viewConnections", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "service", "required": false, "schema": { "enum": ["mysql"], "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Database connections", "tags": ["control"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["database_queries.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Database connections", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/mysql/kill-query": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.killQuery", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "thread_id": { "minimum": 1, "type": "integer" } }, "required": ["confirmed", "thread_id"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Kill database query", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["database_queries.terminate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Kill database query", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/opcache/flush": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.flushOpcache", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" } }, "required": ["confirmed"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Flush OPcache", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Flush OPcache", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/php/restart": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.restartPhp", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" } }, "required": ["confirmed"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Restart PHP", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Restart PHP", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/redis/restart": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.restartRedis", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "redis_role": { "enum": ["cache", "session", "config-cache"], "type": "string" } }, "required": ["confirmed"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Restart Redis", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["services.operate"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Restart Redis", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/scale": { "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.scale", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "confirmed": { "const": true, "type": "boolean" }, "resource": { "enum": ["php-fpm"], "type": "string" }, "target": { "minimum": 1, "type": "integer" } }, "required": ["confirmed", "resource", "target"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Scale resources", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "action_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["scale.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Scale resources", "presented": true } } }, "/api/v1/t/{team}/a/{app}/services/status/{action_id}": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "control.getActionStatus", "parameters": [ { "in": "path", "name": "action_id", "required": true, "schema": { "minLength": 1, "type": "string" } }, { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_id": { "type": "string" }, "action_type": { "type": "string" }, "created_at": { "type": "string" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "result": {}, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" }, "workflow_id": { "type": "string" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Action status", "tags": ["control"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["operations.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Action status", "presented": true } } }, "/api/v1/t/{team}/a/{app}/site-configuration": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "control.getSiteConfiguration", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "query", "name": "app_id", "required": true, "schema": { "description": "App identifier returned by list_apps.", "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": true, "properties": { "revision_token": { "minLength": 1, "type": "string" } }, "required": ["revision_token"], "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Site configuration", "tags": ["control"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Site configuration", "presented": true } }, "post": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires confirmed: true and an Idempotency-Key.", "operationId": "control.configureServices", "parameters": [ { "in": "path", "name": "app", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "pattern": "\\S", "type": "string" }, "x-mcp-argument-name": "idempotency_key" } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "anyOf": [ { "required": ["services"] }, { "required": ["resources"] }, { "required": ["config"] } ], "properties": { "app_id": { "description": "App identifier returned by list_apps.", "type": "string" }, "config": { "additionalProperties": false, "properties": { "phpIni": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "additionalProperties": false, "properties": { "cron": { "additionalProperties": { "type": "string" }, "type": "object" }, "web": { "additionalProperties": { "type": "string" }, "type": "object" } }, "type": "object" } ] } }, "type": "object" }, "confirmed": { "const": true, "type": "boolean" }, "resources": { "additionalProperties": false, "properties": { "coraza": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" } }, "type": "object" }, "cron": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" } }, "type": "object" }, "mysql": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "memory_request": { "type": "string" } }, "type": "object" }, "nfs": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "memory_request": { "type": "string" } }, "type": "object" }, "nginx": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "cpu_request": { "type": "string" } }, "type": "object" }, "opensearch": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "memory_request": { "type": "string" } }, "type": "object" }, "php_fpm": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "cpu_request": { "type": "string" } }, "type": "object" }, "rabbitmq": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "memory_request": { "type": "string" } }, "type": "object" }, "redis": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" } }, "type": "object" }, "varnish": { "additionalProperties": false, "properties": { "burst": { "additionalProperties": false, "properties": { "cpu": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] }, "memory": { "oneOf": [ { "enum": ["off", "unlimited"], "type": "string" }, { "additionalProperties": false, "properties": { "cap": { "type": "string" } }, "required": ["cap"], "type": "object" }, { "additionalProperties": false, "properties": { "multiple": { "type": "number" } }, "required": ["multiple"], "type": "object" } ] } }, "type": "object" }, "memory_request": { "type": "string" } }, "type": "object" } }, "type": "object" }, "revision_token": { "minLength": 1, "type": "string" }, "services": { "additionalProperties": false, "properties": { "mysql": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "opensearch": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "php_cli": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "php_fpm": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "rabbitmq": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "redis": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" }, "varnish": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "engine": { "type": "string" }, "extensions": { "items": { "type": "string" }, "type": "array" }, "invalidation": { "enum": ["ban", "xkey"], "type": "string" }, "params": { "additionalProperties": { "oneOf": [ { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, { "additionalProperties": { "oneOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] }, "type": "object" } ] }, "type": "object" }, "roles": { "additionalProperties": { "additionalProperties": false, "properties": { "enabled": { "type": "boolean" }, "memory_request": { "type": "string" } }, "type": "object" }, "type": "object" }, "version": { "minLength": 1, "type": "string" } }, "type": "object" } }, "type": "object" } }, "required": ["app_id", "confirmed", "revision_token"], "type": "object" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deployment_id": { "type": "string" }, "status": { "const": "dispatched", "type": "string" } }, "required": ["deployment_id", "status"], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Configure services", "tags": ["control"], "x-synsmarts-async": { "mode": "durable", "operation_id_field": "deployment_id" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": true }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["config.write"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": true }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "destructive", "x-synsmarts-ui": { "label": "Configure services", "presented": true } } }, "/api/v1/t/{team}/a/{app}/tracing": { "get": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Read-only.", "operationId": "tracing.getConfiguration", "parameters": [ { "in": "path", "name": "team", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "app", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "applying": { "type": "boolean" }, "can_edit": { "type": "boolean" }, "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "required": ["web", "cron", "ssh"], "type": "object" }, "revision": { "type": "string" }, "trigger_query": { "type": "string" }, "trigger_token": { "type": "string" } }, "required": [ "mode", "php_runtimes", "revision", "applying", "can_edit" ], "type": "object" } } }, "description": "Successful response" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Conflict" }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unprocessable entity" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Get request tracing configuration", "tags": ["tracing"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["config.read"], "x-synsmarts-publication": { "api": "public", "mcp": "unavailable" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Request tracing configuration", "presented": true } }, "put": { "description": "Scoped to the addressed App; the {team} and {app} path segments select the resource and the credential authorizes access. MCP tools supply their app_id through the canonical App path segment. Mutating operation; requires an Idempotency-Key.", "operationId": "tracing.updateConfiguration", "parameters": [ { "in": "path", "name": "team", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "app", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "minLength": 1, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "oneOf": [ { "additionalProperties": false, "anyOf": [ { "required": ["mode"] }, { "required": ["php_runtimes"] } ], "properties": { "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "type": "object" }, "revision": { "minLength": 1, "type": "string" } }, "required": ["revision"], "type": "object" }, { "additionalProperties": false, "properties": { "action": { "const": "roll_token", "type": "string" }, "revision": { "minLength": 1, "type": "string" } }, "required": ["action", "revision"], "type": "object" } ], "properties": { "action": { "const": "roll_token", "type": "string" }, "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "type": "object" }, "revision": { "minLength": 1, "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deployment_id": { "type": "string" }, "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "no_change": { "type": "boolean" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "required": ["web", "cron", "ssh"], "type": "object" }, "revision": { "type": "string" }, "status": { "enum": ["dispatched", "no_change"], "type": "string" }, "trigger_query": { "type": "string" }, "trigger_token": { "type": "string" } }, "required": [ "mode", "php_runtimes", "revision", "status", "no_change", "deployment_id" ], "type": "object" } } }, "description": "No-change response" }, "202": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "deployment_id": { "type": "string" }, "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "no_change": { "type": "boolean" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "required": ["web", "cron", "ssh"], "type": "object" }, "revision": { "type": "string" }, "status": { "enum": ["dispatched", "no_change"], "type": "string" }, "trigger_query": { "type": "string" }, "trigger_token": { "type": "string" } }, "required": [ "mode", "php_runtimes", "revision", "status", "no_change", "deployment_id" ], "type": "object" } } }, "description": "Operation accepted" }, "400": { "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ProblemDetails" }, { "properties": { "error_code": { "enum": [ "INVALID_JSON", "TRACING_PHP_RUNTIMES_INVALID" ], "type": "string" } }, "type": "object" } ] } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "409": { "content": { "application/problem+json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/ProblemDetails" }, { "properties": { "mode": { "enum": ["triggered", "on", "off"], "type": "string" }, "php_runtimes": { "additionalProperties": false, "properties": { "cron": { "enum": ["on", "off"], "type": "string" }, "ssh": { "enum": ["on", "off"], "type": "string" }, "web": { "enum": ["on", "off"], "type": "string" } }, "required": ["web", "cron", "ssh"], "type": "object" }, "revision": { "type": "string" }, "tracing_status": { "const": "queued", "type": "string" }, "trigger_token": { "type": "string" } }, "type": "object" } ] } } }, "description": "Conflict" }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unprocessable entity" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Update request tracing configuration", "tags": ["tracing"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": true }, "x-synsmarts-permissions": ["config.write"], "x-synsmarts-publication": { "api": "public", "mcp": "unavailable" }, "x-synsmarts-revision-token": { "required": true }, "x-synsmarts-scope": "app", "x-synsmarts-side-effect": "configuration", "x-synsmarts-ui": { "label": "Update request tracing configuration", "presented": true } } }, "/api/v1/t/{team}/billing/invoices": { "get": { "description": "Scoped to the addressed Team; the {team} path segment selects the resource and the credential authorizes access. Read-only.", "operationId": "billing.listInvoices", "parameters": [ { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Invoices", "tags": ["billing"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["billing.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "team", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Invoices", "presented": true } } }, "/api/v1/t/{team}/billing/invoices/{invoice_id}": { "get": { "description": "Scoped to the addressed Team; the {team} path segment selects the resource and the credential authorizes access. Read-only.", "operationId": "billing.getInvoice", "parameters": [ { "in": "path", "name": "invoice_id", "required": true, "schema": { "description": "Invoice ID or 'current'.", "minLength": 1, "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Invoice detail", "tags": ["billing"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["billing.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "team", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Invoice detail", "presented": true } } }, "/api/v1/t/{team}/billing/usage": { "get": { "description": "Scoped to the addressed Team; the {team} path segment selects the resource and the credential authorizes access. Read-only.", "operationId": "billing.getUsage", "parameters": [ { "in": "query", "name": "period", "required": false, "schema": { "description": "Billing period as YYYY-MM; defaults to current.", "pattern": "^(current|[0-9]{4}-(0[1-9]|1[0-2]))$", "type": "string" } }, { "in": "path", "name": "team", "required": true, "schema": { "type": "string" }, "x-mcp-context": true } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "action_type": { "type": "string" }, "count": { "minimum": 0, "type": "integer" }, "cursor": { "type": ["string", "null"] }, "data": { "type": "object" }, "deploy_id": { "type": "string" }, "explain_rows": { "items": {}, "type": "array" }, "fpm_status": {}, "has_more": { "type": "boolean" }, "interrogation_type": { "type": "string" }, "items": { "items": {}, "type": "array" }, "limit": { "minimum": 0, "type": "integer" }, "next_cursor": { "type": "string" }, "offset": { "minimum": 0, "type": "integer" }, "pod_resources": { "items": {}, "type": "array" }, "process_list": { "items": {}, "type": "array" }, "redactions_applied": { "minimum": 0, "type": "integer" }, "redis_info": { "type": "object" }, "request_id": { "type": "string" }, "result": {}, "result_size_bytes": { "minimum": 0, "type": "integer" }, "rows": { "items": {}, "type": "array" }, "source": { "type": "string" }, "status": { "type": "string" }, "tenant_id": { "type": "string" }, "time_range": { "type": "string" }, "total": { "minimum": 0, "type": "integer" }, "truncated": { "type": "boolean" } }, "type": "object" } } }, "description": "Successful response" }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Bad request" }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Unauthorized" }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Forbidden" }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Not found" }, "429": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Rate limited" }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Internal server error" }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } }, "description": "Service unavailable" } }, "summary": "Billing usage", "tags": ["billing"], "x-synsmarts-async": { "mode": "synchronous" }, "x-synsmarts-audit": { "required": true }, "x-synsmarts-cli": { "command": null, "presented": false }, "x-synsmarts-confirmation": { "required": false }, "x-synsmarts-idempotency": { "required": false }, "x-synsmarts-permissions": ["billing.read"], "x-synsmarts-publication": { "api": "public", "mcp": "public" }, "x-synsmarts-revision-token": { "required": false }, "x-synsmarts-scope": "team", "x-synsmarts-side-effect": "read", "x-synsmarts-ui": { "label": "Billing usage", "presented": true } } } }, "security": [{ "bearerAuth": [] }, { "apiKeyAuth": [] }], "servers": [{ "url": "https://api.synsmarts.io" }], "tags": [ { "description": "Deploy application releases, inspect deployment status and history, and roll back releases.", "name": "deployment", "x-displayName": "Deployments" }, { "description": "Run investigations and inspect reports, telemetry, traces, configuration, queries, and code.", "name": "diagnostics", "x-displayName": "Diagnostics" }, { "description": "Inspect and operate App services and reconcile customer configuration.", "name": "control", "x-displayName": "Service operations" }, { "description": "Read team-scoped usage and invoices.", "name": "billing", "x-displayName": "Billing" }, { "description": "Inspect environments and purchased resource allocations.", "name": "environment", "x-displayName": "Environments" }, { "description": "Read live runtime status and service information for an App.", "name": "live", "x-displayName": "Live status" }, { "description": "Read customer-visible audit events for an App.", "name": "audit", "x-displayName": "Audit" }, { "description": "List available backups for an App.", "name": "backups", "x-displayName": "Backups" }, { "description": "Inspect App domain, DNS, and TLS status.", "name": "dnsTls", "x-displayName": "DNS & TLS" }, { "description": "Read and update resource-addressed request tracing.", "name": "tracing", "x-displayName": "Request tracing" } ] }