{"openapi":"3.1.0","info":{"title":"NEXUS AI API","version":"1.1.0","description":"Programmatic deployment and infrastructure interface for NEXUS AI.\n\nTwo origins: the GPT-compatible API at https://mcp.nexusai.run/api/gpt (full request and response schemas) and the platform API at https://api.nexusai.run/api (per-operation `servers`).\nAll requests use a Bearer access token (prefix `nxk_`). GPT API rate limits are 20 deploy or delete requests per hour and 60 read requests per minute per organization.\nErrors: the GPT API returns `ErrorResponse`; the platform API returns `PlatformError`. See https://agents.nexusai.run/docs/errors.md."},"servers":[{"url":"https://mcp.nexusai.run/api/gpt","description":"NEXUS GPT-compatible API"}],"security":[{"BearerAuth":[]}],"paths":{"/uploads/zip":{"post":{"operationId":"uploadZip","summary":"Upload a zip archive for source deployments","description":"Upload a zip file to use with source deployments.","tags":["Uploads"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["archive"],"properties":{"archive":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Upload accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceUploadResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/providers":{"get":{"operationId":"listProviders","summary":"List available deployment providers","description":"Get deployment providers available for the authenticated organization plan.","tags":["Providers"],"responses":{"200":{"description":"Providers available for the plan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProvidersResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/deploy":{"post":{"operationId":"deployContainer","summary":"Deploy a container","description":"Deploy a container from a Docker image. Returns immediately with deployment ID.\nPoll the status endpoint to track deployment progress.\n","tags":["Deployments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeployRequest"},"examples":{"nginx":{"summary":"Deploy nginx","value":{"image":"nginx:latest","port":80,"name":"my-nginx"}},"nodeApp":{"summary":"Deploy Node.js app","value":{"image":"node:18-alpine","port":3000,"name":"my-node-app","envVars":{"NODE_ENV":"production","API_KEY":"secret123"}}},"withIdempotency":{"summary":"Idempotent deployment","value":{"image":"nginx:latest","port":80,"name":"my-nginx","requestId":"unique-request-id-123"}}}}}},"responses":{"202":{"description":"Deployment accepted and queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeployResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient scope or provider not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded or quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/deploy/source":{"post":{"operationId":"deploySource","summary":"Deploy a repo or zip source","description":"Deploy from a Git repository or an uploaded zip archive.\nFor zip deployments, call /uploads/zip first and pass the uploadId.\n","tags":["Deployments"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploySourceRequest"}}}},"responses":{"202":{"description":"Deployment accepted and queued","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeployResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Insufficient scope or provider not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded or quota exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/deployments/{id}":{"get":{"operationId":"getDeploymentStatus","summary":"Get deployment status","description":"Get the current status and details of a deployment.","tags":["Deployments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Deployment ID","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Deployment status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploymentStatusResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Deployment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"servers":[{"url":"https://mcp.nexusai.run/api/gpt","description":"NEXUS GPT-compatible API"},{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"x-nexus-platform-operation":{"operationId":"platform_getDeployment","summary":"Get deployment details","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"delete":{"operationId":"destroyDeployment","summary":"Destroy deployment","description":"Permanently destroy a deployment and release all resources.\nThis action cannot be undone.\n","tags":["Deployments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Deployment ID","schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"Deployment destroyed successfully"},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Deployment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"servers":[{"url":"https://mcp.nexusai.run/api/gpt","description":"NEXUS GPT-compatible API"},{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"x-nexus-platform-operation":{"operationId":"platform_deleteDeployment","summary":"Delete a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}}},"/deployments":{"get":{"operationId":"listDeployments","summary":"List deployments","description":"List deployments created via GPT Store API.","tags":["Deployments"],"parameters":[{"name":"status","in":"query","required":false,"description":"Filter by deployment status","schema":{"$ref":"#/components/schemas/DeploymentStatus"}},{"name":"provider","in":"query","required":false,"description":"Filter by provider","schema":{"type":"string","enum":["docker","gcp_cloud_run","azure_container_apps","aws_ecs_fargate"]}},{"name":"limit","in":"query","required":false,"description":"Max deployments to return (default 20, max 100)","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"offset","in":"query","required":false,"description":"Offset for pagination","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"Deployments list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploymentListResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"servers":[{"url":"https://mcp.nexusai.run/api/gpt","description":"NEXUS GPT-compatible API"},{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"x-nexus-platform-operation":{"operationId":"platform_listDeployments","summary":"List deployments","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read"}},"post":{"operationId":"platform_createDeployment","summary":"Create a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.create","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployments/{id}/logs":{"get":{"operationId":"getDeploymentLogs","summary":"Get deployment logs","description":"Fetch container logs for a deployment.","tags":["Deployments"],"parameters":[{"name":"id","in":"path","required":true,"description":"Deployment ID","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of log lines to return (default 100, max 1000)","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}}],"responses":{"200":{"description":"Deployment logs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeploymentLogsResponse"}}}},"401":{"description":"Invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Deployment not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"servers":[{"url":"https://mcp.nexusai.run/api/gpt","description":"NEXUS GPT-compatible API"},{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"x-nexus-platform-operation":{"operationId":"platform_getDeploymentLogs","summary":"Get deployment logs","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.logs","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}}},"/projects":{"get":{"operationId":"platform_listProjects","summary":"List projects","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.read","x-nexus-risk":"read"},"post":{"operationId":"platform_createProject","summary":"Create a project","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.create","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"framework":{"type":"string"},"repoUrl":{"type":"string"},"gitBranch":{"type":"string"},"gitTokenSecretId":{"type":"string","description":"ID of a vault secret that holds a private-repo token"},"vaultEnvironment":{"type":"string","enum":["DEVELOPMENT","STAGING","PRODUCTION"]}},"required":["name"]}}}}}},"/projects/{id}":{"get":{"operationId":"platform_getProject","summary":"Get a project","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"put":{"operationId":"platform_updateProject","summary":"Update a project","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.update","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"delete":{"operationId":"platform_deleteProject","summary":"Delete a project","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.delete","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/projects/{id}/members":{"get":{"operationId":"platform_listProjectMembers","summary":"List project members","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"operationId":"platform_addProjectMember","summary":"Add a project member","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.members.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string"},"role":{"type":"string"}},"required":["userId","role"]}}}}}},"/projects/{id}/members/{userId}":{"patch":{"operationId":"platform_updateProjectMember","summary":"Update a project member","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.members.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"role":{"type":"string"}},"required":["role"]}}}}},"delete":{"operationId":"platform_removeProjectMember","summary":"Remove a project member","tags":["Projects"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"project.members.manage","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}]}},"/builder/sessions":{"post":{"operationId":"platform_createBuilderSession","summary":"Create an AI Builder session","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}":{"get":{"operationId":"platform_getBuilderSession","summary":"Get an AI Builder session","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/builder/sessions/{id}/messages":{"post":{"operationId":"platform_sendBuilderMessage","summary":"Send a message to an AI Builder session","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/messages/stream":{"post":{"operationId":"platform_streamBuilderMessage","summary":"Stream a Builder response","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/revert":{"post":{"operationId":"platform_revertBuilderSession","summary":"Revert a Builder session checkpoint","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/files":{"put":{"operationId":"platform_saveBuilderFiles","summary":"Save Builder files","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/share":{"post":{"operationId":"platform_shareBuilderSession","summary":"Create a Builder share","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/shares/{slug}":{"delete":{"operationId":"platform_revokeBuilderShare","summary":"Revoke a Builder share","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}]}},"/builder/shares/{slug}/remix":{"post":{"operationId":"platform_remixBuilderShare","summary":"Remix a Builder share","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/model":{"put":{"operationId":"platform_setBuilderModel","summary":"Set the Builder model","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/providers":{"get":{"operationId":"platform_listBuilderProviders","summary":"List configured AI Builder providers","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/builder/sessions/{id}/provider":{"put":{"operationId":"platform_setBuilderProvider","summary":"Set the Builder provider","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/sandbox":{"put":{"operationId":"platform_setBuilderSandbox","summary":"Configure the Builder sandbox","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/sandbox/sync":{"post":{"operationId":"platform_syncBuilderSandbox","summary":"Synchronize the Builder sandbox","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/sessions/{id}/github":{"get":{"operationId":"platform_getBuilderGithubStatus","summary":"Get Builder GitHub status","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/builder/sessions/{id}/github/push":{"post":{"operationId":"platform_pushBuilderToGithub","summary":"Push Builder files to GitHub","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/projects/{projectId}/session":{"post":{"operationId":"platform_getOrCreateBuilderProjectSession","summary":"Get or create a project Builder session","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/builder/import/github":{"post":{"operationId":"platform_importGithubToBuilder","summary":"Import a GitHub repository into the Builder","tags":["AI Builder"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployments/{id}/redeploy":{"post":{"operationId":"platform_redeployDeployment","summary":"Redeploy a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.create","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"envVars":{"type":"object","additionalProperties":{"type":"string"}}}}}}}}},"/deployments/{id}/stop":{"post":{"operationId":"platform_stopDeployment","summary":"Stop a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployments/{id}/start":{"post":{"operationId":"platform_startDeployment","summary":"Start a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployments/{id}/health":{"get":{"operationId":"platform_getDeploymentHealth","summary":"Get deployment health","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployments/{id}/container-metrics":{"get":{"operationId":"platform_getDeploymentMetrics","summary":"Get deployment container metrics","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployments/{id}/container-metrics/history":{"get":{"operationId":"platform_getDeploymentMetricsHistory","summary":"Get deployment metrics history","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployments/{id}/scale":{"post":{"operationId":"platform_scaleDeployment","summary":"Scale a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"replicas":{"type":"integer","minimum":0}},"required":["replicas"]}}}}}},"/deployments/{id}/rollback":{"post":{"operationId":"platform_rollbackDeployment","summary":"Roll back a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetDeploymentId":{"type":"string","description":"Earlier deployment version to restore; defaults to the previous one"}}}}}}}},"/deployments/{id}/exec":{"post":{"operationId":"platform_execDeploymentCommand","summary":"Execute a command in a deployment","tags":["Deployments"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"command":{"type":"string"},"timeoutSeconds":{"type":"integer","maximum":1800},"workingDir":{"type":"string"}},"required":["command"]}}}}}},"/deployments/{deploymentId}/domains":{"post":{"operationId":"platform_addCustomDomain","summary":"Add a custom domain","tags":["Custom domains"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"deploymentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Hostname, for example app.example.com"}},"required":["domain"]}}}}},"get":{"operationId":"platform_listCustomDomains","summary":"List custom domains","tags":["Custom domains"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.read","x-nexus-risk":"read","parameters":[{"name":"deploymentId","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployments/{deploymentId}/domains/{domainId}/verify":{"post":{"operationId":"platform_verifyCustomDomain","summary":"Verify a custom domain","tags":["Custom domains"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"write","parameters":[{"name":"deploymentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployments/{deploymentId}/domains/{domainId}":{"delete":{"operationId":"platform_removeCustomDomain","summary":"Remove a custom domain","tags":["Custom domains"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"deployment.manage","x-nexus-risk":"destructive","parameters":[{"name":"deploymentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"domainId","in":"path","required":true,"schema":{"type":"string"}}]}},"/db-sources":{"post":{"operationId":"platform_connectDatabaseSource","summary":"Connect an external database source","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"engine":{"type":"string","enum":["POSTGRESQL","MYSQL"]},"host":{"type":"string"},"port":{"type":"integer"},"dbName":{"type":"string"},"sslMode":{"type":"string"},"username":{"type":"string"},"password":{"type":"string"}},"required":["name","engine","host","port","dbName","username","password"]}}}}},"get":{"operationId":"platform_listDatabaseSources","summary":"List external database sources","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/db-sources/{id}":{"get":{"operationId":"platform_getDatabaseSource","summary":"Get an external database source","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"platform_deleteDatabaseSource","summary":"Remove an external database source","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/db-sources/{id}/test":{"post":{"operationId":"platform_testDatabaseSource","summary":"Test an external database connection","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/db-sources/{id}/schema":{"get":{"operationId":"platform_inspectDatabaseSchema","summary":"Inspect an external database schema","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/db-sources/{id}/query":{"post":{"operationId":"platform_executeDatabaseQuery","summary":"Execute a database query","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sql":{"type":"string"},"mode":{"type":"string","enum":["preview","execute"],"default":"preview"},"limits":{"type":"object"},"confirmed":{"type":"boolean","description":"Required for DML and DDL"}},"required":["sql"]}}}}}},"/db-sources/{id}/propose-fix":{"post":{"operationId":"platform_proposeDatabaseFix","summary":"Propose a database schema fix","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"logSnippet":{"type":"string","description":"Runtime error log to diagnose"},"deploymentId":{"type":"string"}},"required":["logSnippet"]}}}}}},"/db-fix-proposals/{id}/apply":{"post":{"operationId":"platform_applyDatabaseFix","summary":"Apply a reviewed database fix","tags":["Database intelligence"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployment-services":{"get":{"operationId":"platform_listDeploymentDatabaseServices","summary":"List deployment database services","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/deployment-services/{serviceId}/backup":{"post":{"operationId":"platform_createDatabaseBackup","summary":"Create a database backup","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployment-services/{serviceId}/backups":{"get":{"operationId":"platform_listDatabaseBackups","summary":"List database backups","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployment-services/{serviceId}/backups/upload":{"post":{"operationId":"platform_uploadDatabaseBackup","summary":"Upload a database backup","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}}},"/deployment-services/{serviceId}/restore":{"post":{"operationId":"platform_restoreDatabaseBackup","summary":"Restore a database backup","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"backupId":{"type":"string"}},"required":["backupId"]}}}}}},"/deployment-services/{targetServiceId}/restore-from/{backupId}":{"post":{"operationId":"platform_restoreBackupToService","summary":"Restore a backup to another service","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"targetServiceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/deployment-services/{serviceId}/backups/{backupId}":{"delete":{"operationId":"platform_deleteDatabaseBackup","summary":"Delete a database backup","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"backupId","in":"path","required":true,"schema":{"type":"string"}}]}},"/deployment-services/{serviceId}/backup/schedule":{"patch":{"operationId":"platform_updateDatabaseBackupSchedule","summary":"Update database backup scheduling","tags":["Backups"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"serviceId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"retentionDays":{"type":"integer","minimum":7,"description":"Defaults to 7 and cannot go lower"}},"required":["enabled"]}}}}}},"/volumes":{"get":{"operationId":"platform_listVolumes","summary":"List persistent volumes","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createVolume","summary":"Create a persistent volume","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"displayName":{"type":"string"}},"required":["name"]}}}}}},"/volumes/{id}":{"delete":{"operationId":"platform_deleteVolume","summary":"Delete a persistent volume","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/volumes/{id}/attach":{"post":{"operationId":"platform_attachVolume","summary":"Attach a persistent volume","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deploymentId":{"type":"string"},"mountPath":{"type":"string","default":"/data"}},"required":["deploymentId"]}}}}}},"/volumes/{id}/detach":{"post":{"operationId":"platform_detachVolume","summary":"Detach a persistent volume","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/volumes/{id}/refresh-usage":{"post":{"operationId":"platform_refreshVolumeUsage","summary":"Refresh volume usage","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/buckets":{"get":{"operationId":"platform_listBuckets","summary":"List object-storage buckets","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createBucket","summary":"Create an object-storage bucket","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"displayName":{"type":"string"},"region":{"type":"string","default":"us-east-1"}},"required":["name"]}}}}}},"/buckets/{id}":{"delete":{"operationId":"platform_deleteBucket","summary":"Delete an object-storage bucket","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/buckets/{id}/attach":{"post":{"operationId":"platform_attachBucket","summary":"Attach a bucket to a deployment","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deploymentId":{"type":"string"}},"required":["deploymentId"]}}}}}},"/buckets/{id}/detach":{"post":{"operationId":"platform_detachBucket","summary":"Detach a bucket from a deployment","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deploymentId":{"type":"string"}},"required":["deploymentId"]}}}}}},"/buckets/{id}/rotate-credentials":{"post":{"operationId":"platform_rotateBucketCredentials","summary":"Rotate bucket credentials","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/buckets/{id}/files":{"get":{"operationId":"platform_listBucketFiles","summary":"List bucket files","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/buckets/{id}/files/{key}":{"put":{"operationId":"platform_uploadBucketFile","summary":"Upload a bucket file","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}}},"delete":{"operationId":"platform_deleteBucketFile","summary":"Delete a bucket file","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}]}},"/buckets/{id}/files/{key}/download":{"get":{"operationId":"platform_downloadBucketFile","summary":"Download a bucket file","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}]}},"/buckets/{id}/files/{key}/download-url":{"post":{"operationId":"platform_createBucketDownloadUrl","summary":"Create a signed bucket download URL","tags":["Storage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"key","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ttlSeconds":{"type":"integer","minimum":30,"maximum":3600,"default":300}}}}}}}},"/managed-databases":{"get":{"operationId":"platform_listManagedDatabases","summary":"List managed databases","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createManagedDatabase","summary":"Create a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"displayName":{"type":"string"},"provider":{"type":"string","enum":["NEXUS_DOCKER","AWS_RDS","GCP_CLOUD_SQL","AZURE_DATABASE"]},"engine":{"type":"string","description":"postgres or redis on NEXUS_DOCKER; postgres or mysql on cloud providers"},"engineVersion":{"type":"string"},"instanceClass":{"type":"string","description":"Cloud only"},"allocatedGb":{"type":"integer","minimum":20,"maximum":1000},"region":{"type":"string","description":"Cloud only"},"networkMode":{"type":"string","enum":["public","vpc"]},"databaseName":{"type":"string","description":"NEXUS_DOCKER only; default appdb"},"username":{"type":"string","description":"NEXUS_DOCKER only"},"password":{"type":"string","description":"NEXUS_DOCKER only; generated when omitted"}},"required":["name","engine"]}}}}}},"/managed-databases/{id}":{"get":{"operationId":"platform_getManagedDatabase","summary":"Get a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"operationId":"platform_deleteManagedDatabase","summary":"Delete a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/managed-databases/{id}/connection":{"get":{"operationId":"platform_getManagedDatabaseConnection","summary":"Get managed database connection information","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/managed-databases/{id}/attach":{"post":{"operationId":"platform_attachManagedDatabase","summary":"Attach a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deploymentId":{"type":"string"},"envPrefix":{"type":"string","description":"Default DATABASE, or REDIS for Redis"}},"required":["deploymentId"]}}}}}},"/managed-databases/{id}/detach":{"post":{"operationId":"platform_detachManagedDatabase","summary":"Detach a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"deploymentId":{"type":"string"}},"required":["deploymentId"]}}}}}},"/managed-databases/{id}/snapshots":{"post":{"operationId":"platform_createManagedDatabaseSnapshot","summary":"Create a managed database snapshot","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"notes":{"type":"string"}}}}}}},"get":{"operationId":"platform_listManagedDatabaseSnapshots","summary":"List managed database snapshots","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/managed-databases/{id}/restore":{"post":{"operationId":"platform_restoreManagedDatabase","summary":"Restore a managed database","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"snapshotId":{"type":"string"},"newName":{"type":"string","description":"Name of the new database the snapshot restores into"}},"required":["snapshotId","newName"]}}}}}},"/managed-databases/{id}/query":{"post":{"operationId":"platform_queryManagedDatabase","summary":"Run a managed database query","tags":["Managed databases"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sql":{"type":"string","description":"One statement. See https://agents.nexusai.run/docs/sql-safety.md for what is allowed"},"params":{"type":"array","items":{}}},"required":["sql"]}}}}}},"/secrets":{"get":{"operationId":"platform_listSecrets","summary":"List secret metadata","tags":["Secrets"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createSecret","summary":"Create a secret","tags":["Secrets"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"environment":{"type":"string","description":"For example PRODUCTION"},"value":{"type":"string"}},"required":["name","environment","value"]}}}}}},"/secrets/{id}":{"put":{"operationId":"platform_updateSecret","summary":"Update a secret","tags":["Secrets"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"environment":{"type":"string"},"value":{"type":"string"},"status":{"type":"string"}}}}}}},"delete":{"operationId":"platform_deleteSecret","summary":"Delete a secret","tags":["Secrets"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/usage/ai-requests":{"get":{"operationId":"platform_getAiRequestUsage","summary":"Get AI request usage","tags":["Usage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/usage/stats":{"get":{"operationId":"platform_getUsageStats","summary":"Get usage statistics","tags":["Usage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/usage/history":{"get":{"operationId":"platform_getUsageHistory","summary":"Get usage history","tags":["Usage"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/audit/logs":{"get":{"operationId":"platform_getAuditLogs","summary":"Get audit logs","tags":["Audit"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/audit/security-summary":{"get":{"operationId":"platform_getSecuritySummary","summary":"Get a security summary","tags":["Audit"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/audit/security-metrics":{"get":{"operationId":"platform_getSecurityMetrics","summary":"Get security metrics","tags":["Audit"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/audit/event-types":{"get":{"operationId":"platform_getAuditEventTypes","summary":"List audit event types","tags":["Audit"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/support/tickets":{"post":{"operationId":"platform_createSupportTicket","summary":"Create a support ticket","tags":["Support"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subject":{"type":"string"},"description":{"type":"string"},"priority":{"type":"string","enum":["LOW","MEDIUM","HIGH","URGENT"],"default":"MEDIUM"},"category":{"type":"string","default":"general"}},"required":["subject","description"]}}}}},"get":{"operationId":"platform_listSupportTickets","summary":"List support tickets","tags":["Support"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/support/tickets/{id}":{"get":{"operationId":"platform_getSupportTicket","summary":"Get a support ticket","tags":["Support"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/support/tickets/{id}/messages":{"post":{"operationId":"platform_replyToSupportTicket","summary":"Reply to a support ticket","tags":["Support"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}}}}}},"/support/tickets/{id}/status":{"patch":{"operationId":"platform_updateSupportTicketStatus","summary":"Update support ticket status","tags":["Support"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["OPEN","IN_PROGRESS","RESOLVED","CLOSED"]}},"required":["status"]}}}}}},"/github/repos":{"get":{"operationId":"platform_listGithubRepos","summary":"List GitHub repositories","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/github/bindings":{"get":{"operationId":"platform_listGithubBindings","summary":"List GitHub deployment bindings","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createGithubBinding","summary":"Create a GitHub deployment binding","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/github/bindings/{id}":{"put":{"operationId":"platform_updateGithubBinding","summary":"Update a GitHub deployment binding","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"delete":{"operationId":"platform_deleteGithubBinding","summary":"Delete a GitHub deployment binding","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/github/bindings/{id}/deploy":{"post":{"operationId":"platform_triggerGithubBindingDeploy","summary":"Trigger a GitHub binding deployment","tags":["GitHub"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/ai-providers":{"get":{"operationId":"platform_listAiProviders","summary":"List configured AI providers","tags":["AI providers"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createAiProvider","summary":"Create an AI provider configuration","tags":["AI providers"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string"},"apiKey":{"type":"string"},"secretId":{"type":"string","description":"Use a vault secret instead of apiKey"},"model":{"type":"string"},"maxTokens":{"type":"integer"},"temperature":{"type":"number"},"baseUrl":{"type":"string","description":"OpenAI-compatible endpoints only"}},"required":["provider"]}}}}}},"/ai-providers/{id}":{"put":{"operationId":"platform_updateAiProvider","summary":"Update an AI provider configuration","tags":["AI providers"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"string"},"secretId":{"type":"string"},"model":{"type":"string"},"maxTokens":{"type":"integer"},"temperature":{"type":"number"},"enabled":{"type":"boolean"},"baseUrl":{"type":"string"}}}}}}},"delete":{"operationId":"platform_deleteAiProvider","summary":"Delete an AI provider configuration","tags":["AI providers"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"destructive","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]}},"/organizations/roles":{"get":{"operationId":"platform_listOrganizationRoles","summary":"List organization roles","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/organizations/users":{"get":{"operationId":"platform_listOrganizationUsers","summary":"List organization users","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/organizations/users/invite":{"post":{"operationId":"platform_inviteOrganizationUser","summary":"Invite an organization user","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/organizations/users/{userId}/role":{"patch":{"operationId":"platform_updateOrganizationUserRole","summary":"Update an organization user role","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/organizations/deployment-settings":{"get":{"operationId":"platform_getDeploymentSettings","summary":"Get organization deployment settings","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"patch":{"operationId":"platform_updateDeploymentSettings","summary":"Update organization deployment settings","tags":["Organizations"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/tokens":{"get":{"operationId":"platform_listAccessTokens","summary":"List access tokens","tags":["Tokens"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"post":{"operationId":"platform_createAccessToken","summary":"Create an access token","tags":["Tokens"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"expiresAt":{"type":"string","format":"date-time"}},"required":["name","scopes"]}}}}}},"/tokens/{id}/revoke":{"post":{"operationId":"platform_revokeAccessToken","summary":"Revoke an access token","tags":["Tokens"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/users/profile":{"get":{"operationId":"platform_getUserProfile","summary":"Get the authenticated user profile","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"},"patch":{"operationId":"platform_updateUserProfile","summary":"Update the authenticated user profile","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/users/change-password":{"post":{"operationId":"platform_changePassword","summary":"Change the authenticated user password","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/2fa/status":{"get":{"operationId":"platform_getTwoFactorStatus","summary":"Get two-factor authentication status","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/2fa/setup/totp":{"post":{"operationId":"platform_setupTotp","summary":"Set up TOTP two-factor authentication","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/2fa/verify/totp":{"post":{"operationId":"platform_verifyTotp","summary":"Verify and enable TOTP","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/2fa/setup/email":{"post":{"operationId":"platform_setupEmailTwoFactor","summary":"Set up email two-factor authentication","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/2fa/disable":{"post":{"operationId":"platform_disableTwoFactor","summary":"Disable two-factor authentication","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/2fa/backup-codes/regenerate":{"post":{"operationId":"platform_regenerateTwoFactorBackupCodes","summary":"Regenerate two-factor backup codes","tags":["Accounts"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/billing/status":{"get":{"operationId":"platform_getBillingStatus","summary":"Get subscription status","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.read","x-nexus-risk":"read"}},"/billing/trial/start":{"post":{"operationId":"platform_startBillingTrial","summary":"Start a billing trial","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/billing/checkout":{"post":{"operationId":"platform_createBillingCheckout","summary":"Create a billing checkout session","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/billing/checkout/healthcare":{"post":{"operationId":"platform_createHealthcareBillingCheckout","summary":"Create a healthcare billing checkout session","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/billing/portal":{"post":{"operationId":"platform_createBillingPortal","summary":"Create a billing portal session","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/billing/subscription":{"patch":{"operationId":"platform_changeBillingSubscription","summary":"Change a subscription","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}},"delete":{"operationId":"platform_cancelBillingSubscription","summary":"Cancel a subscription","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"204":{"description":"Resource deleted"},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"destructive"}},"/billing/invoices":{"get":{"operationId":"platform_listBillingInvoices","summary":"List billing invoices","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"read"}},"/billing/invoices/{invoiceId}":{"get":{"operationId":"platform_getBillingInvoice","summary":"Get a billing invoice","tags":["Billing"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"billing.manage","x-nexus-risk":"read","parameters":[{"name":"invoiceId","in":"path","required":true,"schema":{"type":"string"}}]}},"/notifications":{"get":{"operationId":"platform_listNotifications","summary":"List user notifications","tags":["Notifications"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/notifications/unread-count":{"get":{"operationId":"platform_getUnreadNotificationCount","summary":"Get the unread notification count","tags":["Notifications"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/notifications/read-all":{"patch":{"operationId":"platform_markAllNotificationsRead","summary":"Mark all notifications as read","tags":["Notifications"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/notifications/{id}/read":{"patch":{"operationId":"platform_markNotificationRead","summary":"Mark one notification as read","tags":["Notifications"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/dashboard/organization":{"get":{"operationId":"platform_getOrganizationDashboard","summary":"Get the organization dashboard","tags":["Dashboard"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/dashboard/analytics/deployments":{"get":{"operationId":"platform_getDeploymentAnalytics","summary":"Get deployment analytics","tags":["Dashboard"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"read"}},"/ai/generate":{"post":{"operationId":"platform_generateAiResponse","summary":"Generate an AI response","tags":["AI"],"servers":[{"url":"https://api.nexusai.run/api","description":"Authenticated NEXUS platform API"}],"responses":{"200":{"description":"JSON response","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request, or the request was blocked by a safety check","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"401":{"description":"Invalid or missing Bearer token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"403":{"description":"Insufficient scope or permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"404":{"description":"Resource not found in the caller organization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformError"}}}}},"x-nexus-required-permission":"NEXUS authentication and RBAC","x-nexus-risk":"write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"NEXUS AI Access Token (prefix: nxk_).\nRequired scopes depend on the endpoint:\n- deployments:create - Deploy containers\n- deployments:read - View deployment status\n- deployments:delete - Destroy deployments\n- deployments:logs - View deployment logs\n"}},"schemas":{"DeployRequest":{"type":"object","required":["image","port"],"properties":{"image":{"type":"string","description":"Docker image to deploy (e.g., nginx:latest, node:18-alpine)","example":"nginx:latest"},"port":{"type":"integer","description":"Port the container listens on","minimum":1,"maximum":65535,"example":80},"name":{"type":"string","description":"Optional friendly name for the deployment","maxLength":63,"pattern":"^[a-z0-9][a-z0-9-]*[a-z0-9]$","example":"my-nginx"},"envVars":{"type":"object","description":"Environment variables to set in the container","additionalProperties":{"type":"string"},"example":{"NODE_ENV":"production"}},"provider":{"type":"string","description":"Cloud provider to use for deployment","enum":["docker","gcp_cloud_run","azure_container_apps","aws_ecs_fargate"],"default":"docker"},"region":{"type":"string","description":"Region for cloud deployments (provider-specific)","example":"us-central1"},"autoDestroyHours":{"type":"number","description":"Automatically destroy deployment after this many hours","minimum":0.5,"maximum":720,"example":24},"requestId":{"type":"string","description":"Optional idempotency key. If provided, duplicate requests with the\nsame requestId within 24 hours will return the existing deployment\ninstead of creating a new one.\n","maxLength":64,"example":"unique-request-id-123"}}},"DeploySourceRequest":{"type":"object","required":["sourceType"],"properties":{"sourceType":{"type":"string","enum":["repo","zip"],"description":"Source type to deploy"},"name":{"type":"string","description":"Optional friendly name for the deployment"},"repoUrl":{"type":"string","description":"Git repository URL (required for repo deployments)"},"repoBranch":{"type":"string","description":"Repository branch (optional)"},"repoSecretName":{"type":"string","description":"Secrets Vault name that stores the repo token"},"uploadId":{"type":"string","description":"Upload ID returned by /uploads/zip (required for zip deployments)"},"envVars":{"type":"object","additionalProperties":{"type":"string"}},"provider":{"type":"string","description":"Cloud provider to use for deployment","enum":["docker","gcp_cloud_run","azure_container_apps","aws_ecs_fargate"],"default":"docker"},"region":{"type":"string","description":"Region for cloud deployments (provider-specific)"},"autoDestroyHours":{"type":"number","description":"Automatically destroy deployment after this many hours","minimum":0.5,"maximum":720},"requestId":{"type":"string","description":"Optional idempotency key"},"framework":{"type":"string","description":"Optional framework hint (e.g., node, python, nextjs)"},"dockerfile":{"type":"string","description":"Optional custom Dockerfile content"},"buildCommand":{"type":"string","description":"Optional build command"},"startCommand":{"type":"string","description":"Optional start command"},"installCommand":{"type":"string","description":"Optional install command"},"outputDir":{"type":"string","description":"Optional build output directory"}}},"DeployResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique deployment ID"},"status":{"$ref":"#/components/schemas/DeploymentStatus"},"name":{"type":"string","description":"Deployment name"},"url":{"type":"string","format":"uri","nullable":true,"description":"Public URL (available when running)"},"createdAt":{"type":"string","format":"date-time","description":"When the deployment was created"},"requestId":{"type":"string","description":"Echo of the requestId if provided"}}},"DeploymentStatusResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique deployment ID"},"status":{"$ref":"#/components/schemas/DeploymentStatus"},"name":{"type":"string","description":"Deployment name"},"url":{"type":"string","format":"uri","nullable":true,"description":"Public URL (available when running)"},"provider":{"type":"string","description":"Cloud provider used"},"createdAt":{"type":"string","format":"date-time","description":"When the deployment was created"},"startedAt":{"type":"string","format":"date-time","nullable":true,"description":"When the container started running"},"error":{"type":"string","nullable":true,"description":"Error message if deployment failed"}}},"DeploymentListItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique deployment ID"},"status":{"$ref":"#/components/schemas/DeploymentStatus"},"name":{"type":"string","description":"Deployment name"},"url":{"type":"string","format":"uri","nullable":true,"description":"Public URL (available when running)"},"provider":{"type":"string","description":"Cloud provider used"},"createdAt":{"type":"string","format":"date-time","description":"When the deployment was created"},"startedAt":{"type":"string","format":"date-time","nullable":true,"description":"When the container started running"},"autoDestroyAt":{"type":"string","format":"date-time","nullable":true,"description":"When the deployment will be auto-destroyed"}}},"DeploymentListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/DeploymentListItem"}},"total":{"type":"integer","description":"Total deployments matching the filter"},"limit":{"type":"integer","description":"Limit used for pagination"},"offset":{"type":"integer","description":"Offset used for pagination"}}},"DeploymentLogsResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Deployment ID"},"logs":{"type":"array","items":{"type":"string"},"description":"Log lines from the container"},"hasMore":{"type":"boolean","description":"Whether there are more logs available"}}},"SourceUploadResponse":{"type":"object","properties":{"uploadId":{"type":"string","description":"Upload identifier to use with source deployments"},"expiresAt":{"type":"string","format":"date-time","description":"When the upload expires"}}},"ProvidersResponse":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","enum":["docker","gcp_cloud_run","azure_container_apps","aws_ecs_fargate"]},"name":{"type":"string","description":"Display name for the provider"}}}},"planTier":{"type":"string","description":"Organization plan tier"}}},"DeploymentStatus":{"type":"string","enum":["queued","deploying","running","failed","terminated"],"description":"Current deployment status:\n- queued: Waiting to be processed\n- deploying: Container is being built/started\n- running: Container is running and accessible\n- failed: Deployment failed (check error field)\n- terminated: Container was stopped or destroyed\n"},"ErrorResponse":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message"},"code":{"type":"string","description":"Machine-readable error code","enum":["INVALID_TOKEN","TOKEN_EXPIRED","INSUFFICIENT_SCOPE","RATE_LIMIT_EXCEEDED","DEPLOYMENT_NOT_FOUND","PROJECT_NOT_FOUND","INVALID_REQUEST","DEPLOYMENT_FAILED","DUPLICATE_REQUEST","QUOTA_EXCEEDED","PROVIDER_NOT_ALLOWED","INTERNAL_ERROR"]},"details":{"type":"object","description":"Additional error details","additionalProperties":true}}},"PlatformError":{"type":"object","properties":{"status":{"type":"string"},"message":{"type":"string","description":"Human-readable reason, for example \"Query blocked: Statement type not permitted\""}},"required":["message"]}}}}