{ "openapi": "3.1.0", "info": { "title": "usine operator API", "version": "unversioned", "description": "Read instance state, manage configuration, and operate runs. Requests use instance bearer tokens or browser sessions. API paths remain under /api." }, "paths": { "/api/upgrade": { "get": { "tags": [ "Operator" ], "operationId": "operator.upgradeStatus", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/UpgradeView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns the running release, available release, and upgrade progress.", "summary": "Read upgrade status", "x-usine-permission": "admin" }, "delete": { "tags": [ "Operator" ], "operationId": "operator.cancelUpgrade", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Cancels a pending upgrade before installation begins and resumes deferred runs.", "summary": "Cancel a waiting upgrade", "x-usine-permission": "admin" }, "post": { "tags": [ "Operator" ], "operationId": "operator.requestUpgrade", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Accepts an upgrade when idle or an immediate restart. Poll upgrade status for the outcome.", "summary": "Request an upgrade", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeRequestEncoded" } } }, "required": true }, "x-usine-permission": "admin" } }, "/api/version": { "get": { "tags": [ "Operator" ], "operationId": "operator.serverVersion", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "string" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Public health check that returns the running release string.", "summary": "Read the running release", "x-usine-permission": "public" } }, "/api/ready": { "get": { "tags": [ "Operator" ], "operationId": "operator.serverReady", "parameters": [], "security": [], "responses": { "200": { "description": "Startup recovery has finished and runtime routes are available.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Readiness", "description": "Startup recovery has finished and runtime routes are available." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "Starting" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Public readiness check. Returns 503 with Retry-After during startup recovery and 200 after runtime routes are installed.", "summary": "Check startup readiness", "x-usine-permission": "public" } }, "/api/changes": { "get": { "tags": [ "Operator" ], "operationId": "operator.changes", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "text/event-stream": { "schema": { "type": "string" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Streams authorized entity identifiers and monotonic revisions. Resumes from Last-Event-ID or requests a cache reset.", "summary": "Subscribe to entity change notices", "x-usine-permission": "read" } }, "/api/workers": { "get": { "tags": [ "Operator" ], "operationId": "operator.workers", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "workers": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerConfigurationViewEncoded" } }, "removedWorkers": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RemovedWorkerViewEncoded" } } }, "required": [ "workers", "removedWorkers" ], "additionalProperties": false } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns configured and removed workers with current slot usage.", "summary": "Read workers and slot usage", "x-usine-permission": "admin" } }, "/api/overview": { "get": { "tags": [ "Operator" ], "operationId": "operator.overview", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ReadyOverviewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_NeedsSetupOverviewEncoded" } ] } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns project boards, loops, workers, and instance readiness.", "summary": "Read the instance overview", "x-usine-permission": "read" } }, "/api/attention/dismiss": { "post": { "tags": [ "Operator" ], "operationId": "operator.dismissNeed", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Acknowledges the current attention item until its state changes.", "summary": "Dismiss an attention item", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_engine_AttentionKeyEncoded" } } }, "required": true }, "x-usine-permission": "admin" } }, "/api/attention/undo": { "post": { "tags": [ "Operator" ], "operationId": "operator.undoDismissNeed", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Removes the acknowledgement for the supplied attention item.", "summary": "Undo an attention dismissal", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_engine_AttentionKeyEncoded" } } }, "required": true }, "x-usine-permission": "admin" } }, "/api/agents": { "get": { "tags": [ "Operator" ], "operationId": "operator.agents", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns the names of saved agent definitions available for runs.", "summary": "List agents", "x-usine-permission": "read" } }, "/api/runs/{runId}/edit-and-retry": { "post": { "tags": [ "Operator" ], "operationId": "operator.editAndRetry", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Retries a failed run with the supplied task or agent changes.", "summary": "Edit and retry a run", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_EditAndRetryEncoded" } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/runs/{runId}/run-again": { "post": { "tags": [ "Operator" ], "operationId": "operator.runAgain", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_engine_ClaimedEncoded" }, { "$ref": "#/components/schemas/_usine_engine_CycleBlockedEncoded" } ] } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Opens a new run for a succeeded or canceled run and returns the admission result.", "summary": "Run an item again", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_EditAndRetryEncoded" } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/runs/{runId}/intervene": { "post": { "tags": [ "Operator" ], "operationId": "operator.intervene", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Sends a message to the selected session of a running attempt.", "summary": "Send an operator message", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_SessionInterventionEncoded" } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/cycle-budgets/reset": { "post": { "tags": [ "Operator" ], "operationId": "operator.resetCycleBudget", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/CycleBudgetResetView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_CycleBudgetResetViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Answers an open cycle budget ask and allows the item to run again. Returns the blocked CI fix events that the reset replayed; a repeated answer returns an empty list.", "summary": "Reset an item cycle budget", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "askId": { "type": "string", "minLength": 1 } }, "required": [ "askId" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/runs/{runId}": { "get": { "tags": [ "Operator" ], "operationId": "operator.detail", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true }, { "name": "after", "in": "query", "required": false, "description": "Return messages after this sequence. Cannot be combined with before or attempt.", "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, { "name": "before", "in": "query", "required": false, "description": "Return messages before this sequence. Requires attempt; cannot be combined with after.", "schema": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, { "name": "attempt", "in": "query", "required": false, "description": "Attempt to read earlier messages from. Requires before; cannot be combined with after.", "schema": { "type": "string", "minLength": 1 } } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/RunDetailView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_RunDetailViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Without cursors, returns the latest transcript page. Use after for updates, or before and attempt together for earlier messages.", "summary": "Read a run and its transcript", "x-usine-permission": "read" } }, "/api/runs/{runId}/github-changes": { "get": { "tags": [ "Operator" ], "operationId": "operator.githubChanges", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/RunGitHubChangesView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_RunGitHubChangesViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns GitHub writes grouped by attempt window.", "summary": "Read GitHub changes for a run", "x-usine-permission": "read" } }, "/api/runs/{runId}/approve": { "post": { "tags": [ "Operator" ], "operationId": "operator.approve", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Records the signed-in member approval for a run waiting at a gate.", "summary": "Approve a waiting run", "x-usine-permission": "operate" } }, "/api/runs/{runId}/resolve-failure": { "post": { "tags": [ "Operator" ], "operationId": "operator.resolveFailure", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Acknowledges the supplied failed attempt only while it remains the current failure.", "summary": "Resolve a run failure", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 } }, "required": [ "attemptId" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/runs/{runId}/apply-ci-labels": { "post": { "tags": [ "Operator" ], "operationId": "operator.applyCiLabels", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "For a run whose CI wait ended because CI on its head didn't finish, checks that CI on the same head has passed with every workflow run concluded, applies the wait's completion labels, and resolves the supplied failed attempt.", "summary": "Apply CI labels after CI passes", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 } }, "required": [ "attemptId" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/runs/{runId}/retry": { "post": { "tags": [ "Operator" ], "operationId": "operator.retry", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Starts another attempt of a failed run with its saved definitions.", "summary": "Retry a failed run", "x-usine-permission": "operate" } }, "/api/runs/{runId}/cancel": { "post": { "tags": [ "Operator" ], "operationId": "operator.cancel", "parameters": [ { "name": "runId", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Cancels an open run and requests that any active attempt stop.", "summary": "Cancel a run", "x-usine-permission": "operate" } }, "/api/projects/{project}": { "get": { "tags": [ "Operator" ], "operationId": "operator.project", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/ProjectView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_ProjectViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns the project and its board across member repositories.", "summary": "Read a project board", "x-usine-permission": "read" } }, "/api/projects/{project}/lanes/{lane}/items": { "get": { "tags": [ "Operator" ], "operationId": "operator.boardLaneItems", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "lane", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true }, { "name": "offset", "in": "query", "schema": { "type": "string", "pattern": "^[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:[Ee][+-]?\\d+)?$" }, "required": false } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BoardTaskViewEncoded" } }, "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "nextOffset": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "items", "total", "nextOffset" ], "additionalProperties": false } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns up to 50 items and the next offset for a project lane.", "summary": "Read the next page of board cards", "x-usine-permission": "read" } }, "/api/projects/{project}/pull-requests/{repository}/{item}/files": { "get": { "tags": [ "Operator" ], "operationId": "operator.pullRequestFiles", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "repository", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string", "pattern": "^[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:[Ee][+-]?\\d+)?$" }, "required": true }, { "name": "scope", "in": "query", "required": true, "description": "Select the whole PR or a commit range.", "schema": { "type": "string", "enum": [ "PullRequestFiles", "CommitRangeFiles" ] } }, { "name": "head", "in": "query", "required": true, "description": "The full pushed head commit SHA.", "schema": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, { "name": "base", "in": "query", "required": true, "description": "The full PR base commit SHA or attempt checkout base commit SHA.", "schema": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "FileChanges", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileChangesEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns commit-pinned files for a whole pull request or a comparison from an attempt checkout base to its pushed head. Reports missing patches and truncated file lists. Requires read access to the repository's project.", "summary": "Read pull request or attempt changes", "x-usine-permission": "read" } }, "/api/projects/{project}/tasks/{item}": { "get": { "tags": [ "Operator" ], "operationId": "operator.projectTask", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "repository", "in": "query", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/TaskView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_TaskViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns linked issues, pull requests, and runs for an item in a project repository.", "summary": "Read a project task", "x-usine-permission": "read" } }, "/api/projects/{project}/items/{item}/lane": { "post": { "tags": [ "Operator" ], "operationId": "operator.moveProjectItem", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Changes the GitHub labels of the task current item to match the destination lane.", "summary": "Move a project item", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "toLane": { "type": "string", "minLength": 1 } }, "required": [ "repository", "toLane" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/loops/{project}/{loop}/pause": { "post": { "tags": [ "Operator" ], "operationId": "operator.pauseProjectLoop", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "loop", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Stops the loop from opening new runs without canceling existing runs.", "summary": "Pause a project loop", "x-usine-permission": "operate" } }, "/api/loops/{project}/{loop}/unpause": { "post": { "tags": [ "Operator" ], "operationId": "operator.unpauseProjectLoop", "parameters": [ { "name": "project", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true }, { "name": "loop", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Allows the loop to open runs for matching items.", "summary": "Resume a project loop", "x-usine-permission": "operate" } }, "/api/projects/{owner}/{repository}/items/{item}/lane": { "post": { "tags": [ "Operator" ], "operationId": "operator.moveBoardItem", "parameters": [ { "name": "owner", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "repository", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Moves the item using the lanes of the project that contains its repository.", "summary": "Move a repository item", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "toLane": { "type": "string", "minLength": 1 } }, "required": [ "toLane" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "operate" } }, "/api/workers/{worker}/preflight": { "post": { "tags": [ "Operator" ], "operationId": "operator.runWorkerPreflight", "parameters": [ { "name": "worker", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/WorkerPreflightView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPreflightViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Checks one idle worker and replaces its stored capability results, including failures with remediation. Returns 409 while an attempt or another preflight uses the worker.", "summary": "Run worker preflight", "x-usine-permission": "admin" } }, "/api/workers/{worker}/discard-leftovers": { "post": { "tags": [ "Operator" ], "operationId": "operator.discardLeftovers", "parameters": [ { "name": "worker", "in": "path", "schema": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Discards a removed worker only after its running attempts have ended.", "summary": "Discard worker leftovers", "x-usine-permission": "admin" } }, "/api/loops/{loop}/pause": { "post": { "tags": [ "Operator" ], "operationId": "operator.pause", "parameters": [ { "name": "loop", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Accepts a qualified project/loop name, or a short name while it is unique. Encode slashes in the path segment.", "summary": "Pause a loop", "x-usine-permission": "operate" } }, "/api/loops/{loop}/unpause": { "post": { "tags": [ "Operator" ], "operationId": "operator.unpause", "parameters": [ { "name": "loop", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request was accepted. An asynchronous action may still be running.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "title": "Acknowledgement", "description": "The request was accepted. An asynchronous action may still be running." } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Accepts a qualified project/loop name, or a short name while it is unique. Encode slashes in the path segment.", "summary": "Resume a loop", "x-usine-permission": "operate" } }, "/api/projects/{owner}/{repository}/tasks/{item}/runs": { "get": { "tags": [ "Operator" ], "operationId": "operator.taskRuns", "parameters": [ { "name": "owner", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "repository", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "offset", "in": "query", "schema": { "type": "string", "pattern": "^[+-]?(?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:[Ee][+-]?\\d+)?$" }, "required": false } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "runs": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RunViewEncoded" } }, "total": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "nextOffset": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "runs", "total", "nextOffset" ], "additionalProperties": false } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns up to 25 runs and the next offset for a repository task.", "summary": "Read a page of task runs", "x-usine-permission": "read" } }, "/api/projects/{owner}/{repository}/tasks/{item}": { "get": { "tags": [ "Operator" ], "operationId": "operator.task", "parameters": [ { "name": "owner", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "repository", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+$" }, "required": true }, { "name": "item", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/TaskView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_TaskViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns linked items and runs for the repository item.", "summary": "Read a repository task", "x-usine-permission": "read" } }, "/api/configuration/loops/check": { "post": { "tags": [ "Operator" ], "operationId": "operator.checkLoop", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "LoopCheck", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoopCheckEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Checks the proposed loop, CEL expressions, and prompt without saving a revision.", "summary": "Check a loop definition", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*\\/)?[a-z0-9]+(?:-[a-z0-9]+)*$" }, "value": {}, "text": { "not": {} } }, "required": [ "name", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*\\/)?[a-z0-9]+(?:-[a-z0-9]+)*$" }, "text": { "type": "string" }, "value": { "not": {} } }, "required": [ "name", "text" ], "additionalProperties": false } ] } } }, "required": true }, "x-usine-permission": "maintain" } }, "/api/configuration/loops/preview": { "post": { "tags": [ "Operator" ], "operationId": "operator.previewLoop", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "LoopPreview", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoopPreviewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Evaluates the proposed loop against stored GitHub items without making GitHub requests or saving a revision.", "summary": "Preview a loop", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoopPreviewRequestEncoded" } } }, "required": true }, "x-usine-permission": "read" } }, "/api/configuration/head": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationHead", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "number": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "number" ], "additionalProperties": false } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Returns the revision number used to detect stale configuration writes.", "summary": "Read the current configuration revision", "x-usine-permission": "read" } }, "/api/configuration/capabilities": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationCapabilities", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "harnesses": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" } }, "harnessDetails": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_agents_HarnessPresentationEncoded" } }, "efforts": { "type": "array", "items": { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] } } }, "required": [ "harnesses", "harnessDetails", "efforts" ], "additionalProperties": false } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns supported harnesses and reasoning efforts.", "summary": "List configuration capabilities", "x-usine-permission": "read" } }, "/api/configuration/repositories": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationRepositories", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns repositories available to the instance GitHub App installation.", "summary": "List installation repositories", "x-usine-permission": "admin" } }, "/api/configuration/labels/{repository}": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationLabels", "parameters": [ { "name": "repository", "in": "path", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_github_RepositoryLabelEncoded" } } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Reads live GitHub labels. Encode the repository slash in the path segment.", "summary": "List repository labels", "x-usine-permission": "read" } }, "/api/configuration/revisions": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationRevisions", "parameters": [ { "name": "kind", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false }, { "name": "identifier", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false }, { "name": "before", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false }, { "name": "limit", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationRevisionPage", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationRevisionPageEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Returns a page of revisions, newest first. Pass nextBefore as before for the next page; the default limit is 50.", "summary": "List configuration revisions", "x-usine-permission": "read" } }, "/api/configuration/revisions/{number}": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationRevision", "parameters": [ { "name": "number", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationRevisionView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationRevisionViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Returns each changed entity with its values before and after the revision.", "summary": "Read a configuration revision", "x-usine-permission": "read" } }, "/api/configuration/entities/{kind}/{identifier}": { "get": { "tags": [ "Operator" ], "operationId": "operator.configurationEntity", "parameters": [ { "name": "kind", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "identifier", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationEntityView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationEntityViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Returns the current JSON value, export-format text, and revision number.", "summary": "Read a configuration entity", "x-usine-permission": "read" }, "put": { "tags": [ "Operator" ], "operationId": "operator.replaceConfigurationEntity", "parameters": [ { "name": "kind", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "identifier", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationRevisionView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationRevisionViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Creates or replaces an entity from value or text. The expected revision rejects stale writes.", "summary": "Replace a configuration entity", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "message": { "type": "string" }, "value": {}, "text": { "not": {} }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expected", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "message": { "type": "string" }, "text": { "type": "string" }, "value": { "not": {} }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "expected", "text" ], "additionalProperties": false } ] } } }, "required": true }, "x-usine-permission": "maintain" }, "delete": { "tags": [ "Operator" ], "operationId": "operator.deleteConfigurationEntity", "parameters": [ { "name": "kind", "in": "path", "schema": { "type": "string" }, "required": true }, { "name": "identifier", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationRevisionView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationRevisionViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Deletes the entity if the expected revision is current.", "summary": "Delete a configuration entity", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationWriteEncoded" } } }, "required": true }, "x-usine-permission": "maintain" } }, "/api/configuration/revisions/{number}/revert": { "post": { "tags": [ "Operator" ], "operationId": "operator.revertConfigurationRevision", "parameters": [ { "name": "number", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "ConfigurationRevisionView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationRevisionViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "StaleRevisionRefusal | ConfigurationRevertRefusal | @usine/orchestrator/RestartRequiredRefusal | @usine/orchestrator/ReloadPreflightRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/StaleRevisionRefusalEncoded" }, { "$ref": "#/components/schemas/ConfigurationRevertRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RestartRequiredRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReloadPreflightRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "422": { "description": "ConfigurationInvalidRefusal | @usine/orchestrator/FactoryConfigRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConfigurationInvalidRefusalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FactoryConfigRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "@usine/orchestrator/ValidationTimeoutRefusal", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ValidationTimeoutRefusalEncoded" }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } ] } } } } }, "description": "Creates a revision restoring earlier values unless later edits conflict.", "summary": "Revert a configuration revision", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationWriteEncoded" } } }, "required": true }, "x-usine-permission": "maintain" } }, "/api/configuration": { "get": { "tags": [ "Operator" ], "operationId": "operator.configuration", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/ConfigurationView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_ConfigurationViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns stored configuration for the configuration editor.", "summary": "Read instance configuration", "x-usine-permission": "read" } }, "/api/desk": { "get": { "tags": [ "Operator" ], "operationId": "operator.desk", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/DeskView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_DeskViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Returns attention items, active attempts, recent runs, and worker slots.", "summary": "Read overview attention and activity", "x-usine-permission": "read" } }, "/api/statistics": { "get": { "tags": [ "Operator" ], "operationId": "operator.statistics", "parameters": [ { "name": "window", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/StatisticsView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_StatisticsViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Aggregates task outcomes and worker utilization for the requested window, defaulting to 30d.", "summary": "Read task statistics", "x-usine-permission": "read" } }, "/api/statistics/runs": { "get": { "tags": [ "Operator" ], "operationId": "operator.runStatistics", "parameters": [ { "name": "window", "in": "query", "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "prefixItems": [ { "type": "string" } ], "minItems": 1, "items": { "type": "string" } } ] }, "required": false } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "@usine/orchestrator/RunStatisticsView", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/_usine_orchestrator_RunStatisticsViewEncoded" } } } }, "400": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Error Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "404": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "409": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "422": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "500": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "502": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } }, "503": { "description": "Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AccessDenied", "WorkerPreflightRejectedError", "UpgradeError", "ConfigurationNotFound", "ConfigurationStoreError", "SchemaError", "InvalidRequestError", "CrossSiteRequestError", "RunNotFoundError", "TranscriptAttemptNotFoundError", "BoardProjectNotFoundError", "BoardItemNotFoundError", "BoardLaneNotFoundError", "GitHubItemNotFoundError", "FileChangesNotFoundError", "PullRequestFilesChangedError", "RunOperationRejectedError", "CiNotPassedError", "RunRetryBlockedError", "RunInterventionRejectedError", "LeftoversDiscardRejectedError", "RosterAgentNotFoundError", "LoopNotFoundError", "CycleBudgetResetRejectedError", "BoardLaneReadOnlyError", "RestartRequiredError", "ReloadPreflightError", "FactoryConfigError", "EnginePersistenceError", "AttemptCancellationError", "HttpBodyError", "GitHubApiError", "InvalidGitHubResponseError", "BackendUnavailableError", "InstallationDiscoveryError", "AppPermissionError", "ProjectNotInstalledError", "GitHubRateLimitError" ], "description": "Domain failure tag that selects the HTTP status." }, "message": { "type": "string", "description": "Diagnostic text safe to show to the operator." } }, "required": [ "error", "message" ], "additionalProperties": false } } } } }, "description": "Aggregates runs, attempts, retries, and durations for the requested window, defaulting to 30d.", "summary": "Read run statistics", "x-usine-permission": "read" } }, "/api/health": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.health", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "sqliteReader": { "type": "string", "enum": [ "worker", "fallback", "respawning" ] } }, "required": [ "ok" ], "additionalProperties": false } } } }, "403": { "description": "Forbidden. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } } }, "description": "Public liveness check with the SQLite reader state; does not require instance setup.", "summary": "Check server health", "x-usine-permission": "public" } }, "/api/auth/info": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.info", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "github": { "type": "boolean" } }, "required": [ "github" ], "additionalProperties": false } } } }, "403": { "description": "Forbidden. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } } }, "description": "Reports whether GitHub sign-in is configured.", "summary": "Read sign-in availability", "x-usine-permission": "public" } }, "/api/auth/session": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.session", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "member": { "anyOf": [ { "$ref": "#/components/schemas/MemberEncoded" }, { "type": "null" } ] }, "permissions": { "type": "array", "items": { "$ref": "#/components/schemas/PermissionGrantEncoded" } }, "operations": { "type": "array", "items": { "type": "string", "pattern": "^[a-z]+\\.[A-Za-z]+$" }, "description": "Operation IDs from this document, such as operator.approve, that the token may call. Requests also need the token's scopes." }, "csrf": { "type": "string" } }, "required": [ "member", "permissions", "csrf" ], "additionalProperties": false } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Returns the signed-in member, effective permissions, the device token's operation ceiling, and the CSRF token. Setup sessions have a null member.", "summary": "Read the current session", "x-usine-permission": "session" } }, "/api/auth/link": { "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.link", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [ "url" ], "additionalProperties": false } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Requires the local admin bearer token. Returns a single-use link valid for ten minutes.", "summary": "Create a sign-in link", "x-usine-permission": "local" } }, "/api/auth/link/consume": { "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.consumeLink", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] }, "bootstrap": { "type": "boolean" } }, "required": [ "ok", "bootstrap" ], "additionalProperties": false } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Consumes the one-time token and sets browser session and CSRF cookies.", "summary": "Consume a sign-in link", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string", "minLength": 1 } }, "required": [ "token" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "public" } }, "/api/auth/github": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.github", "parameters": [], "security": [], "responses": { "302": { "description": "" }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Redirects to GitHub and sets a short-lived state cookie. First enrollment requires a setup session.", "summary": "Start GitHub web sign-in", "x-usine-permission": "public" } }, "/api/auth/callback": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.callback", "parameters": [ { "name": "state", "in": "query", "schema": { "type": "string" }, "required": true }, { "name": "code", "in": "query", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "302": { "description": "" }, "403": { "description": "Forbidden. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } } }, "description": "Verifies state against the browser cookie, sets a session, and redirects to the UI. Failed sign-ins redirect to the sign-in page.", "summary": "Complete GitHub web sign-in", "x-usine-permission": "public" } }, "/api/auth/device": { "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.device", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "userCode": { "type": "string" }, "verificationUri": { "type": "string" }, "interval": { "type": "number" } }, "required": [ "id", "userCode", "verificationUri", "interval" ], "additionalProperties": false } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Returns a challenge, GitHub user code, verification URL, and polling interval in seconds.", "summary": "Start device sign-in", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "name" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "public" } }, "/api/auth/device/poll": { "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.pollDevice", "parameters": [], "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "pending": { "type": "boolean", "enum": [ true ] } }, "required": [ "pending" ], "additionalProperties": false }, { "type": "object", "properties": { "token": { "type": "string" } }, "required": [ "token" ], "additionalProperties": false } ] } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Returns pending until authorization completes, then returns the instance token once. Honor the polling interval.", "summary": "Poll device sign-in", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 } }, "required": [ "id" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "public" } }, "/api/auth/sign-out": { "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.signOut", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request completed successfully.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "description": "The request completed successfully." } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Revokes the current credential and expires browser cookies.", "summary": "Sign out", "x-usine-permission": "session" } }, "/api/members": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.members", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MemberEncoded" } } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Returns enrolled members. Requires a member session or token.", "summary": "List members", "x-usine-permission": "admin" }, "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.addMember", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request completed successfully.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "description": "The request completed successfully." } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Resolves the GitHub login to a numeric identity and enrolls the member.", "summary": "Add a member", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "login": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" } }, "required": [ "login" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "admin" } }, "/api/members/{id}": { "delete": { "tags": [ "Sign-in and members" ], "operationId": "authentication.removeMember", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request completed successfully.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "description": "The request completed successfully." } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Revokes the member credentials and removes membership. The last member cannot be removed.", "summary": "Remove a member", "x-usine-permission": "admin" } }, "/api/tokens": { "get": { "tags": [ "Sign-in and members" ], "operationId": "authentication.tokens", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "createdAt": { "type": "number" }, "lastUsedAt": { "type": "number" }, "scopes": { "type": "array", "items": { "type": "object", "properties": { "permission": { "type": "string", "enum": [ "read", "operate", "maintain", "admin" ] }, "scope": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Instance" ] } }, "required": [ "_tag" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Project" ] }, "project": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "_tag", "project" ], "additionalProperties": false } ] } }, "required": [ "permission", "scope" ], "additionalProperties": false } }, "kind": { "type": "string", "enum": [ "session", "device" ] }, "operations": { "type": "array", "items": { "type": "string", "pattern": "^[a-z]+\\.[A-Za-z]+$" }, "description": "Operation IDs from this document, such as operator.approve, that the token may call. Requests also need the token's scopes." }, "unknownOperations": { "type": "array", "items": { "type": "string", "pattern": "^[a-z]+\\.[A-Za-z]+$" }, "description": "The operation IDs of the ceiling that match no operation, such as an ID that a release renamed. The token cannot call them." }, "expiresAt": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "Epoch milliseconds of expiry, or null for a device token without one." } }, "required": [ "id", "name", "createdAt", "lastUsedAt", "kind", "expiresAt" ], "additionalProperties": false } } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Returns the current member devices and browser sessions, excluding expired credentials and token secrets.", "summary": "List member tokens", "x-usine-permission": "tokens" }, "post": { "tags": [ "Sign-in and members" ], "operationId": "authentication.createToken", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" } }, "required": [ "token" ], "additionalProperties": false } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Creates a device token whose scopes are a subset of the caller's effective permissions, with an optional operation ceiling and expiry. The secret is returned once.", "summary": "Create a scoped token", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "scopes": { "type": "array", "items": { "$ref": "#/components/schemas/PermissionGrantEncoded" } }, "operations": { "type": "array", "items": { "type": "string", "pattern": "^[a-z]+\\.[A-Za-z]+$" }, "description": "Operation IDs from this document, such as operator.approve, that the token may call. Requests also need the token's scopes." }, "expiresAt": { "type": "number", "description": "Epoch milliseconds after which the token stops authenticating." } }, "required": [ "name", "scopes" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "tokens" } }, "/api/tokens/{id}/scopes": { "put": { "tags": [ "Sign-in and members" ], "operationId": "authentication.setScopes", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request completed successfully.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "description": "The request completed successfully." } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Sets the scope ceiling and operation ceiling for one of the member's device tokens. Requests also check current role bindings. Browser sessions follow role bindings and reject scope edits.", "summary": "Set token scopes", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "scopes": { "type": "array", "items": { "$ref": "#/components/schemas/PermissionGrantEncoded" } }, "operations": { "anyOf": [ { "type": "array", "items": { "type": "string", "pattern": "^[a-z]+\\.[A-Za-z]+$" }, "description": "Operation IDs from this document, such as operator.approve, that the token may call. Requests also need the token's scopes." }, { "type": "null" } ], "description": "Replaces the operation ceiling. Null removes it; an absent key keeps the current ceiling." } }, "required": [ "scopes" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "tokens" } }, "/api/tokens/{id}": { "delete": { "tags": [ "Sign-in and members" ], "operationId": "authentication.revokeToken", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string", "minLength": 1 }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "The request completed successfully.", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false, "description": "The request completed successfully." } } } }, "400": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Sign-in or credential operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "429": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "500": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "502": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } }, "503": { "description": "Sign-in or credential operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Sign-in or credential operation failed." } } } } }, "description": "Revokes a device or browser session belonging to the current member.", "summary": "Revoke a token", "x-usine-permission": "tokens" } }, "/api/setup": { "get": { "tags": [ "GitHub App setup" ], "operationId": "setup.status", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "NoApp" ] } }, "required": [ "_tag" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "MissingKey" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "NeedsInstallation" ] }, "url": { "type": "string" }, "message": { "type": "string" } }, "required": [ "_tag", "url", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Repositories" ] }, "signIn": { "type": "boolean" }, "github": { "type": "boolean" } }, "required": [ "_tag", "signIn", "github" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Ready" ] } }, "required": [ "_tag" ], "additionalProperties": false } ] } } } }, "400": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Setup operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "429": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "500": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "502": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "503": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } } }, "description": "Checks App credentials, installation, sign-in, and registry state.", "summary": "Read setup progress", "x-usine-permission": "setup" } }, "/api/setup/manifest": { "post": { "tags": [ "GitHub App setup" ], "operationId": "setup.manifest", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string" }, "manifest": { "type": "string" } }, "required": [ "action", "manifest" ], "additionalProperties": false } } } }, "400": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Setup operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "429": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "500": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "502": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "503": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } } }, "description": "Returns a GitHub form action and manifest, and sets a ten-minute state cookie. POST the manifest to the returned action in the same browser.", "summary": "Prepare GitHub App creation", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 34 }, "organization": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" } }, "required": [ "name" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/setup/callback": { "get": { "tags": [ "GitHub App setup" ], "operationId": "setup.callback", "parameters": [ { "name": "state", "in": "query", "schema": { "type": "string" }, "required": true }, { "name": "code", "in": "query", "schema": { "type": "string" }, "required": true } ], "security": [], "responses": { "302": { "description": "" }, "403": { "description": "Forbidden. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } } }, "description": "Verifies the single-use state and browser cookie, exchanges GitHub's code, and saves credentials. Redirects to setup on success or failure.", "summary": "Complete GitHub App creation", "x-usine-permission": "public" } }, "/api/setup/restore": { "post": { "tags": [ "GitHub App setup" ], "operationId": "setup.restore", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Setup operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "429": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "500": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "502": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "503": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } } }, "description": "Saves credential JSON with mode 0600 when usable credentials are missing. Accepts legacy App ID and private key files with optional client and webhook fields.", "summary": "Restore App credentials", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "credentials": { "type": "string", "minLength": 1 } }, "required": [ "credentials" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/setup/activate": { "post": { "tags": [ "GitHub App setup" ], "operationId": "setup.activate", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean", "enum": [ true ] } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Setup operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "429": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "500": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "502": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "503": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } } }, "description": "Starts the runtime with saved credentials. Poll the runtime endpoint before navigating while the HTTP listener restarts.", "summary": "Activate the configured instance", "x-usine-permission": "setup" } }, "/api/setup/runtime": { "get": { "tags": [ "GitHub App setup" ], "operationId": "setup.runtime", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ready": { "type": "boolean" } }, "required": [ "ready" ], "additionalProperties": false } } } }, "400": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Setup operation failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "429": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "500": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "502": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } }, "503": { "description": "Setup operation failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Setup operation failed." } } } } }, "description": "Returns true when the instance serves the active runtime.", "summary": "Check runtime readiness", "x-usine-permission": "setup" } }, "/api/providers": { "get": { "tags": [ "providers" ], "operationId": "providers.status", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "targets": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "target": { "type": "string" }, "label": { "type": "string" }, "providers": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "anthropic-messages", "openai-responses" ] }, "credential": { "anyOf": [ { "type": "string", "enum": [ "api-key", "subscription" ] }, { "type": "null" } ] }, "expiresAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lastRefresh": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "refreshable": { "type": "boolean" } }, "required": [ "provider", "credential", "expiresAt", "lastRefresh" ], "additionalProperties": false }, { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "anthropic-messages", "openai-responses" ] }, "error": { "type": "string" } }, "required": [ "provider", "error" ], "additionalProperties": false } ] } } }, "required": [ "target", "label", "providers" ], "additionalProperties": false }, { "type": "object", "properties": { "target": { "type": "string" }, "label": { "type": "string" }, "error": { "type": "string" } }, "required": [ "target", "label", "error" ], "additionalProperties": false } ] } }, "logins": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "target": { "type": "string" }, "provider": { "type": "string", "enum": [ "claude", "chatgpt" ] }, "state": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "starting" ] } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "authorizing" ] }, "url": { "type": "string" }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "status", "url", "code" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "connected" ] } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "failed" ] }, "message": { "type": "string" } }, "required": [ "status", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "cancelled" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "id", "target", "provider", "state" ], "additionalProperties": false } } }, "required": [ "targets", "logins" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Returns credential metadata and pending authorization prompts for configured gateways or local harnesses. Requires instance admin or setup access.", "summary": "Read provider connections", "x-usine-permission": "setup" } }, "/api/providers/login": { "post": { "tags": [ "providers" ], "operationId": "providers.begin", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "target": { "type": "string" }, "provider": { "type": "string", "enum": [ "claude", "chatgpt" ] }, "state": { "anyOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": [ "starting" ] } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "authorizing" ] }, "url": { "type": "string" }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "status", "url", "code" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "connected" ] } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "failed" ] }, "message": { "type": "string" } }, "required": [ "status", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "enum": [ "cancelled" ] } }, "required": [ "status" ], "additionalProperties": false } ] } }, "required": [ "id", "target", "provider", "state" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Starts an isolated native provider login. Poll connection status for its authorization page and device code.", "summary": "Start provider sign-in", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "target": { "type": "string", "minLength": 1 }, "provider": { "type": "string", "enum": [ "claude", "chatgpt" ] } }, "required": [ "target", "provider" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/providers/code": { "post": { "tags": [ "providers" ], "operationId": "providers.code", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Passes the code to the pending Claude login. Completed credentials transfer to the configured destination.", "summary": "Submit a Claude authorization code", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "code": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n]+$" } }, "required": [ "id", "code" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/providers/login/{id}": { "delete": { "tags": [ "providers" ], "operationId": "providers.cancel", "parameters": [ { "name": "id", "in": "path", "schema": { "type": "string" }, "required": true } ], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Stops an unfinished login and preserves the previously saved credential.", "summary": "Cancel provider sign-in", "x-usine-permission": "setup" } }, "/api/providers/key": { "put": { "tags": [ "providers" ], "operationId": "providers.key", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Saves an API key on the selected destination and updates gateway worker routing.", "summary": "Connect a provider API key", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "target": { "type": "string", "minLength": 1 }, "provider": { "type": "string", "enum": [ "claude", "chatgpt" ] }, "key": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[^\\r\\n]+$" } }, "required": [ "target", "provider", "key" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/providers/disconnect": { "post": { "tags": [ "providers" ], "operationId": "providers.disconnect", "parameters": [], "security": [ { "bearer": [] }, { "session": [] } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ], "additionalProperties": false } } } }, "400": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "401": { "description": "A valid instance token or browser session is required.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } }, "403": { "description": "Provider connection request failed. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers. Browser session writes require a valid X-Usine-CSRF header.", "content": { "application/json": { "schema": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] }, { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } ] } } } }, "409": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "429": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "500": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "502": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } }, "503": { "description": "Provider connection request failed.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "AuthenticationError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": false, "description": "Provider connection request failed." } } } } }, "description": "Removes the saved credential and gateway worker routing, cancelling any unfinished login for this destination and provider.", "summary": "Disconnect a provider", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "target": { "type": "string", "minLength": 1 }, "provider": { "type": "string", "enum": [ "claude", "chatgpt" ] } }, "required": [ "target", "provider" ], "additionalProperties": false } } }, "required": true }, "x-usine-permission": "setup" } }, "/api/openapi.json": { "get": { "tags": [ "documentation" ], "operationId": "documentation.openapi", "parameters": [], "security": [], "responses": { "200": { "description": "OpenAPI 3.1 description of the instance HTTP API.", "content": { "application/json": { "schema": { "type": "object", "title": "OpenAPI document", "description": "OpenAPI 3.1 description of the instance HTTP API." } } } }, "403": { "description": "Forbidden. Requests with an Origin header require an allowed origin. Unknown origins receive no CORS headers.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "CrossSiteRequestError" ] }, "message": { "type": "string" } }, "required": [ "error", "message" ], "additionalProperties": true } } } } }, "description": "Public OpenAPI 3.1 document generated from the registered API contracts.", "summary": "Read the API schema", "x-usine-permission": "public" } } }, "components": { "schemas": { "PermissionGrantEncoded": { "type": "object", "properties": { "permission": { "type": "string", "enum": [ "read", "operate", "maintain", "admin" ] }, "scope": { "anyOf": [ { "$ref": "#/components/schemas/InstanceScopeEncoded" }, { "$ref": "#/components/schemas/ProjectScopeEncoded" } ] } }, "required": [ "permission", "scope" ], "additionalProperties": false }, "ProjectScopeEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Project" ] }, "project": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "_tag", "project" ], "additionalProperties": false }, "InstanceScopeEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Instance" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "MemberEncoded": { "type": "object", "properties": { "login": { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, "id": { "type": "integer", "maximum": 9007199254740991, "exclusiveMinimum": 0 }, "addedAt": { "type": "number" }, "addedBy": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] } ] } }, "required": [ "login", "id", "addedAt", "addedBy" ], "additionalProperties": false }, "_usine_orchestrator_RunStatisticsViewEncoded": { "type": "object", "properties": { "window": { "type": "string", "enum": [ "7d", "30d", "all" ] }, "from": { "type": "string" }, "to": { "type": "string" }, "bucket": { "type": "string", "enum": [ "day", "week" ] }, "runs": { "$ref": "#/components/schemas/_usine_orchestrator_OutcomeCountsViewEncoded" }, "runTime": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "attemptTime": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "unmeasuredAttempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "throughput": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_ThroughputPeriodViewEncoded" } }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopStatisticsViewEncoded" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AgentStatisticsViewEncoded" } }, "brains": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BrainStatisticsViewEncoded" } }, "queueWait": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerQueueWaitViewEncoded" } }, "attemptsPerRun": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AttemptCountViewEncoded" } }, "utilization": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerUtilizationViewEncoded" } }, "needsAttention": { "$ref": "#/components/schemas/_usine_orchestrator_NeedsAttentionViewEncoded" }, "machineStarts": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_executor_MachineStartsEncoded" } } }, "required": [ "window", "from", "to", "bucket", "runs", "runTime", "attemptTime", "unmeasuredAttempts", "throughput", "loops", "agents", "brains", "queueWait", "attemptsPerRun", "utilization", "needsAttention", "machineStarts" ], "additionalProperties": false }, "_usine_executor_MachineStartsEncoded": { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "provider": { "type": "string", "enum": [ "hetzner", "boat", "boxd" ] }, "day": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "count": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "worker", "provider", "day", "count" ], "additionalProperties": false }, "_usine_orchestrator_NeedsAttentionViewEncoded": { "type": "object", "properties": { "approvals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failures": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "periods": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_NeedsAttentionPeriodViewEncoded" } }, "approvalWait": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "retryWait": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "resolutionWait": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "failureWait": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] } }, "required": [ "approvals", "failures", "periods", "approvalWait", "retryWait", "resolutionWait", "failureWait" ], "additionalProperties": false }, "_usine_orchestrator_DurationSummaryViewEncoded": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "medianMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "count", "medianMillis" ], "additionalProperties": false }, "_usine_orchestrator_NeedsAttentionPeriodViewEncoded": { "type": "object", "properties": { "start": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "approvals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failures": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "start", "approvals", "failures" ], "additionalProperties": false }, "_usine_orchestrator_WorkerUtilizationViewEncoded": { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "slots": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "occupiedMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "share": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "worker", "slots", "occupiedMillis", "share" ], "additionalProperties": false }, "_usine_orchestrator_AttemptCountViewEncoded": { "type": "object", "properties": { "attempts": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "runs": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "attempts", "runs" ], "additionalProperties": false }, "_usine_orchestrator_WorkerQueueWaitViewEncoded": { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "wait": { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" } }, "required": [ "worker", "wait" ], "additionalProperties": false }, "_usine_orchestrator_BrainStatisticsViewEncoded": { "type": "object", "properties": { "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "outcomes": { "$ref": "#/components/schemas/_usine_orchestrator_OutcomeCountsViewEncoded" }, "time": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "usage": { "$ref": "#/components/schemas/_usine_orchestrator_UsageSummaryViewEncoded" } }, "required": [ "brain", "outcomes", "time", "usage" ], "additionalProperties": false }, "_usine_orchestrator_UsageSummaryViewEncoded": { "type": "object", "properties": { "measured": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "meanTokens": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "pools": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_PoolTokensViewEncoded" } }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_CostSummaryViewEncoded" }, { "type": "null" } ] } }, "required": [ "measured", "tokens", "meanTokens", "pools", "cost" ], "additionalProperties": false }, "_usine_orchestrator_CostSummaryViewEncoded": { "type": "object", "properties": { "usd": { "type": "number", "minimum": 0 }, "meanUsd": { "type": "number", "minimum": 0 }, "estimate": { "type": "boolean" }, "priced": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "usd", "meanUsd", "estimate", "priced" ], "additionalProperties": false }, "_usine_orchestrator_PoolTokensViewEncoded": { "type": "object", "properties": { "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "pool", "tokens" ], "additionalProperties": false }, "_usine_orchestrator_OutcomeCountsViewEncoded": { "type": "object", "properties": { "succeeded": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "canceled": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "succeeded", "failed", "canceled" ], "additionalProperties": false }, "Agent_BrainSpecEncoded": { "type": "object", "properties": { "harness": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "model": { "type": "string", "pattern": "\\S" }, "effort": { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] } }, "required": [ "harness", "model", "effort" ], "additionalProperties": false }, "_usine_orchestrator_AgentStatisticsViewEncoded": { "type": "object", "properties": { "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "outcomes": { "$ref": "#/components/schemas/_usine_orchestrator_OutcomeCountsViewEncoded" }, "time": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "usage": { "$ref": "#/components/schemas/_usine_orchestrator_UsageSummaryViewEncoded" } }, "required": [ "agent", "outcomes", "time", "usage" ], "additionalProperties": false }, "_usine_orchestrator_LoopStatisticsViewEncoded": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "outcomes": { "$ref": "#/components/schemas/_usine_orchestrator_OutcomeCountsViewEncoded" }, "time": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_DurationSummaryViewEncoded" }, { "type": "null" } ] }, "usage": { "$ref": "#/components/schemas/_usine_orchestrator_UsageSummaryViewEncoded" } }, "required": [ "loop", "outcomes", "time", "usage" ], "additionalProperties": false }, "_usine_orchestrator_ThroughputPeriodViewEncoded": { "type": "object", "properties": { "start": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "succeeded": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "failed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "canceled": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "start", "succeeded", "failed", "canceled" ], "additionalProperties": false }, "_usine_orchestrator_StatisticsViewEncoded": { "type": "object", "properties": { "window": { "type": "string", "enum": [ "7d", "30d", "all" ] }, "from": { "type": "string" }, "to": { "type": "string" }, "bucket": { "type": "string", "enum": [ "day", "week" ] }, "loops": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "tasks": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TaskDoneViewEncoded" } }, "medianMillis": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "periods": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TaskPeriodViewEncoded" } }, "firstTimeRight": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "memoryKills": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "memoryKillAttempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "repeatedMemoryKillAttempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operatorActions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "time": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_TaskTimeViewEncoded" }, { "type": "null" } ] }, "tokens": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_TaskTokensViewEncoded" }, { "type": "null" } ] }, "untimed": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UntimedTasksViewEncoded" }, { "type": "null" } ] }, "unmetered": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AgentModelsViewEncoded" } } }, "required": [ "window", "from", "to", "bucket", "loops", "tasks", "medianMillis", "periods", "firstTimeRight", "memoryKills", "memoryKillAttempts", "repeatedMemoryKillAttempts", "operatorActions", "time", "tokens", "untimed", "unmetered", "agents" ], "additionalProperties": false }, "_usine_orchestrator_AgentModelsViewEncoded": { "type": "object", "properties": { "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "opened": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "models": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_ModelOutcomeViewEncoded" } } }, "required": [ "agent", "tasks", "opened", "models" ], "additionalProperties": false }, "_usine_orchestrator_ModelOutcomeViewEncoded": { "type": "object", "properties": { "harness": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "model": { "type": "string", "pattern": "\\S" }, "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "mixed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "firstTimeRight": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "medianRounds": { "type": "number", "minimum": 0 }, "medianMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "metered": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "medianTokens": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_TaskCostViewEncoded" }, { "type": "null" } ] } }, "required": [ "harness", "model", "tasks", "mixed", "firstTimeRight", "medianRounds", "medianMillis", "metered", "medianTokens", "cost" ], "additionalProperties": false }, "_usine_orchestrator_TaskCostViewEncoded": { "type": "object", "properties": { "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "medianUsd": { "type": "number", "minimum": 0 }, "estimate": { "type": "boolean" } }, "required": [ "tasks", "medianUsd", "estimate" ], "additionalProperties": false }, "_usine_orchestrator_UntimedTasksViewEncoded": { "type": "object", "properties": { "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "before": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "tasks", "before" ], "additionalProperties": false }, "_usine_orchestrator_TaskTokensViewEncoded": { "type": "object", "properties": { "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "medianTokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopShareViewEncoded" } }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_TaskCostViewEncoded" }, { "type": "null" } ] } }, "required": [ "tasks", "medianTokens", "loops", "cost" ], "additionalProperties": false }, "_usine_orchestrator_LoopShareViewEncoded": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "share": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "loop", "share" ], "additionalProperties": false }, "_usine_orchestrator_TaskTimeViewEncoded": { "type": "object", "properties": { "tasks": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopShareViewEncoded" } }, "waiting": { "type": "number", "minimum": 0, "maximum": 1 }, "runs": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopRunTimeViewEncoded" } } }, "required": [ "tasks", "loops", "waiting", "runs" ], "additionalProperties": false }, "_usine_orchestrator_LoopRunTimeViewEncoded": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "runs": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "medianMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "loop", "runs", "medianMillis" ], "additionalProperties": false }, "_usine_orchestrator_TaskPeriodViewEncoded": { "type": "object", "properties": { "start": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "tasks": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "medianMillis": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "firstTimeRight": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operatorActions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "start", "tasks", "medianMillis", "firstTimeRight", "operatorActions" ], "additionalProperties": false }, "_usine_orchestrator_TaskDoneViewEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "mergedAt": { "type": "string" }, "durationMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "repository", "number", "mergedAt", "durationMillis" ], "additionalProperties": false }, "_usine_orchestrator_DeskViewEncoded": { "type": "object", "properties": { "running": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RunningAttemptViewEncoded" } }, "notMoving": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_StalledItemViewEncoded" } }, "lastOutcomes": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_ClosedRunViewEncoded" } }, "workers": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerViewEncoded" } }, "polls": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RepositoryPollViewEncoded" } } }, "required": [ "running", "notMoving", "lastOutcomes", "workers", "polls" ], "additionalProperties": false }, "_usine_orchestrator_RepositoryPollViewEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "polledAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "repository", "polledAt" ], "additionalProperties": false }, "_usine_orchestrator_WorkerViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "slots": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerSlotsViewEncoded" }, "paused": { "type": "boolean" }, "upgradeWait": { "anyOf": [ { "type": "object", "properties": { "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "since": { "type": "string" } }, "required": [ "target", "since" ], "additionalProperties": false }, { "type": "null" } ] }, "preflight": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_PassedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DegradedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DeferredCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedCheckViewEncoded" }, { "type": "null" } ] }, "machines": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_MachineViewEncoded" } }, "provisioning": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ProvisioningPauseViewEncoded" }, { "type": "null" } ] } }, "required": [ "name", "slots", "preflight", "machines", "provisioning" ], "additionalProperties": false }, "_usine_orchestrator_ProvisioningPauseViewEncoded": { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "capacity", "quota", "refused", "provider", "unreachable", "timeout", "check" ] }, "message": { "type": "string" }, "failures": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "failedAt": { "type": "string" }, "retryAt": { "type": "string" }, "blocked": { "type": "boolean" } }, "required": [ "reason", "message", "failures", "failedAt", "retryAt", "blocked" ], "additionalProperties": false }, "_usine_orchestrator_MachineViewEncoded": { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "provider": { "type": "string", "enum": [ "hetzner", "boat", "boxd" ] }, "state": { "type": "string", "enum": [ "creating", "preparing", "ready", "idle", "deleting" ] }, "id": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" }, { "type": "null" } ] }, "runId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "attemptId": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "since": { "type": "string" }, "attempts": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "worker", "provider", "state", "id", "runId", "attemptId", "since", "attempts" ], "additionalProperties": false }, "_usine_orchestrator_FailedCheckViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Failed" ] }, "checkedAt": { "type": "string" }, "capability": { "anyOf": [ { "type": "string", "enum": [ "machine", "toolchain", "memory", "disk", "harness-login", "credentials", "gateway", "container", "provider" ] }, { "type": "null" } ] }, "message": { "type": "string" } }, "required": [ "_tag", "checkedAt", "capability", "message" ], "additionalProperties": false }, "_usine_orchestrator_DeferredCheckViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Deferred" ] }, "checkedAt": { "type": "string" }, "message": { "type": "string" } }, "required": [ "_tag", "checkedAt", "message" ], "additionalProperties": false }, "_usine_orchestrator_DegradedCheckViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Degraded" ] }, "checkedAt": { "type": "string" }, "message": { "type": "string" } }, "required": [ "_tag", "checkedAt", "message" ], "additionalProperties": false }, "_usine_orchestrator_PassedCheckViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Passed" ] }, "checkedAt": { "type": "string" } }, "required": [ "_tag", "checkedAt" ], "additionalProperties": false }, "_usine_orchestrator_WorkerSlotsViewEncoded": { "type": "object", "properties": { "capacity": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "leased": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "capacity", "leased" ], "additionalProperties": false }, "_usine_orchestrator_ClosedRunViewEncoded": { "type": "object", "properties": { "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, "item": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_BoardItemLinkEncoded" }, { "type": "null" } ] }, "closedAt": { "type": "string" } }, "required": [ "run", "item", "closedAt" ], "additionalProperties": false }, "_usine_orchestrator_BoardItemLinkEncoded": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting" ], "additionalProperties": false }, "_usine_orchestrator_RunSummaryViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "itemKey": { "type": "string", "minLength": 1 }, "loop": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "agentBrain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "state": { "type": "string", "enum": [ "Pending", "Waiting", "Queued", "Running", "AwaitingCi", "Succeeded", "HandedOff", "Failed", "Canceled" ] }, "ciWait": { "anyOf": [ { "type": "object", "properties": { "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "fixLoop": { "type": "string", "minLength": 1 }, "timeoutSeconds": { "type": "integer", "maximum": 86400, "exclusiveMinimum": 0 }, "onGreen": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "add": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }, "remove": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true } }, "required": [ "item", "add", "remove" ], "additionalProperties": false } } }, "required": [ "pullRequest", "head", "fixLoop", "timeoutSeconds", "onGreen" ], "additionalProperties": false }, { "type": "null" } ] }, "handoff": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "HandedOff" ] }, "reason": { "type": "string", "minLength": 1 }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "fixLoop": { "type": "string", "minLength": 1 }, "fixRunId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "reason", "head", "fixLoop", "fixRunId" ], "additionalProperties": false }, { "type": "null" } ] }, "upgradeWait": { "anyOf": [ { "type": "object", "properties": { "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "since": { "type": "string" } }, "required": [ "target", "since" ], "additionalProperties": false }, { "type": "null" } ] }, "providerRetry": { "anyOf": [ { "type": "object", "properties": { "nextAttempt": { "type": "integer", "minimum": 2, "maximum": 9007199254740991 }, "retryAt": { "type": "string" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "nextAttempt", "retryAt", "message" ], "propertyNames": { "anyOf": [ { "enum": [ "nextAttempt", "retryAt", "message" ] }, { "type": "string" } ] }, "additionalProperties": false }, { "type": "null" } ] }, "machineWait": { "anyOf": [ { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string" } }, "required": [ "worker", "message" ], "additionalProperties": false }, { "type": "null" } ] }, "loopPaused": { "type": "boolean" }, "openedAt": { "type": "string" }, "closedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "approval": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalViewEncoded" }, { "type": "null" } ] }, "approvalReason": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "runAgain": { "anyOf": [ { "$ref": "#/components/schemas/RunAgainEncoded" }, { "type": "null" } ] }, "pullRequestUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canApprove": { "type": "boolean" }, "canRetry": { "type": "boolean" }, "canResolveFailure": { "type": "boolean" }, "canApplyCiLabels": { "type": "boolean" }, "canCancel": { "type": "boolean" }, "canRunAgain": { "type": "boolean" }, "attempts": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AttemptSummaryViewEncoded" } } }, "required": [ "id", "itemKey", "loop", "repository", "agent", "agentBrain", "state", "loopPaused", "openedAt", "closedAt", "approval", "runAgain", "pullRequestUrl", "canApprove", "canRetry", "canResolveFailure", "canCancel", "canRunAgain", "attempts" ], "additionalProperties": false }, "_usine_orchestrator_AttemptSummaryViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "workerAccess": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LocalWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_SshWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProvisionedWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_SandboxWorkerAccessEncoded" }, { "type": "null" } ] }, "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "operatorIntervened": { "type": "boolean" }, "startedAt": { "type": "string" }, "outcome": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_SucceededAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AwaitingCiAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_HandedOffAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_CanceledAttemptViewEncoded" }, { "type": "null" } ] }, "endedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "salvage": { "anyOf": [ { "$ref": "#/components/schemas/AttemptSalvage_PushedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_PartlyPushedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_RetainedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_RejectedEncoded" }, { "type": "null" } ] }, "start": { "anyOf": [ { "$ref": "#/components/schemas/AttemptStart_EventEncoded" }, { "$ref": "#/components/schemas/AttemptStart_RetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_EditAndRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_InfraRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_ProviderRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_AfterRestartEncoded" }, { "type": "null" } ] }, "reattachedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "outOfMemory": { "anyOf": [ { "$ref": "#/components/schemas/OutOfMemoryKillsEncoded" }, { "type": "null" } ] } }, "required": [ "id", "number", "worker", "workerAccess", "brain", "agent", "operatorIntervened", "startedAt", "outcome", "endedAt", "salvage", "start", "reattachedAt", "outOfMemory" ], "additionalProperties": false }, "OutOfMemoryKillsEncoded": { "type": "object", "properties": { "kills": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "memoryMib": { "type": "integer", "minimum": 256, "maximum": 9007199254740991 }, "processes": { "type": "array", "items": { "type": "object", "properties": { "command": { "type": "string", "minLength": 1 }, "pid": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "command", "pid" ], "additionalProperties": false } } }, "required": [ "kills", "memoryMib" ], "additionalProperties": false }, "AttemptStart_AfterRestartEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AfterRestart" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptStart_ProviderRetryEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ProviderRetry" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptStart_InfraRetryEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "InfraRetry" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptStart_EditAndRetryEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "EditAndRetry" ] }, "operator": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] } }, "required": [ "_tag", "operator" ], "additionalProperties": false }, "AttemptStart_RetryEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "OperatorRetry" ] }, "operator": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] } }, "required": [ "_tag", "operator" ], "additionalProperties": false }, "AttemptStart_EventEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Event" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptSalvage_RejectedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Rejected" ] }, "path": { "type": "string", "minLength": 1 }, "commit": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "message": { "type": "string" } }, "required": [ "_tag", "path", "commit", "message" ], "additionalProperties": false }, "AttemptSalvage_RetainedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Retained" ] }, "path": { "type": "string", "minLength": 1 }, "commit": { "anyOf": [ { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, { "type": "null" } ] }, "message": { "type": "string" }, "pushFailure": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "GitHubPushFailure" ] }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "ref": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "_tag", "repository", "ref", "message" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "_tag", "path", "commit", "message" ], "additionalProperties": false }, "AttemptSalvage_PartlyPushedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PartlyPushed" ] }, "ref": { "type": "string", "minLength": 1 }, "commit": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "path": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "_tag", "ref", "commit", "path", "message" ], "additionalProperties": false }, "AttemptSalvage_PushedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Pushed" ] }, "ref": { "type": "string", "minLength": 1 }, "commit": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "ref", "commit" ], "additionalProperties": false }, "_usine_orchestrator_CanceledAttemptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Canceled" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_FailedAttemptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Failed" ] }, "failure": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_GitHubPushFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_InfraFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProviderCapacityFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DefectFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AgentFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BlockedFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_QuestionFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunawayFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ChildSessionBudgetFailureViewEncoded" } ] }, "report": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "_tag", "failure", "report" ], "additionalProperties": false }, "_usine_orchestrator_ChildSessionBudgetFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ChildSessionBudgetFailure" ] }, "maxChildren": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "attemptedChildren": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "_tag", "maxChildren", "attemptedChildren" ], "additionalProperties": false }, "_usine_orchestrator_RunawayFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RunawayFailure" ] }, "ceiling": { "type": "string", "enum": [ "wall-clock", "tokens" ] } }, "required": [ "_tag", "ceiling" ], "additionalProperties": false }, "_usine_orchestrator_QuestionFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "QuestionFailure" ] }, "question": { "type": "string" } }, "required": [ "_tag", "question" ], "additionalProperties": false }, "_usine_orchestrator_BlockedFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "BlockedFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_AgentFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AgentFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_DefectFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "DefectFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_ProviderCapacityFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ProviderCapacityFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_InfraFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "InfraFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_GitHubPushFailureViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "GitHubPushFailure" ] }, "message": { "type": "string" } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "_usine_orchestrator_HandedOffAttemptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "HandedOff" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_AwaitingCiAttemptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AwaitingCi" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_SucceededAttemptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Succeeded" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_SandboxWorkerAccessEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Sandbox" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_ProvisionedWorkerAccessEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Provisioned" ] }, "provider": { "type": "string", "enum": [ "hetzner", "boat", "boxd" ] } }, "required": [ "_tag", "provider" ], "additionalProperties": false }, "_usine_orchestrator_SshWorkerAccessEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Ssh" ] }, "destination": { "type": "string", "pattern": "^(?:[A-Za-z0-9._-]+@)?(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|[0-9A-Fa-f]{0,4}(?::[0-9A-Fa-f]{0,4}){2,7})$" }, "port": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 65535 }, { "type": "null" } ] } }, "required": [ "_tag", "destination", "port" ], "additionalProperties": false }, "_usine_orchestrator_LocalWorkerAccessEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Local" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "RunAgainEncoded": { "type": "object", "properties": { "from": { "type": "string", "minLength": 1 }, "requestedBy": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] } }, "required": [ "from", "requestedBy" ], "propertyNames": { "anyOf": [ { "enum": [ "from", "requestedBy" ] }, { "type": "string" } ] }, "additionalProperties": false }, "_usine_orchestrator_ApprovalViewEncoded": { "type": "object", "properties": { "approvedAt": { "type": "string" }, "source": { "anyOf": [ { "$ref": "#/components/schemas/ApprovalSourceEncoded" }, { "type": "null" } ] } }, "required": [ "approvedAt", "source" ], "additionalProperties": false }, "ApprovalSourceEncoded": { "type": "object", "properties": { "channel": { "anyOf": [ { "type": "string", "enum": [ "ui" ] } ] }, "approver": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] } }, "required": [ "channel", "approver" ], "propertyNames": { "anyOf": [ { "enum": [ "channel", "approver" ] }, { "type": "string" } ] }, "additionalProperties": false }, "_usine_orchestrator_StalledItemViewEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "loop": { "type": "string", "minLength": 1 }, "item": { "$ref": "#/components/schemas/_usine_orchestrator_BoardItemLinkEncoded" }, "reason": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_WaitingForUpgradeViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AwaitingApprovalViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_SuppressedForOperatorViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_CycleBudgetUsedUpViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunFailedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ClosedUnchangedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_LoopPausedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WaitingForStopViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_QueuedForWorkerViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AwaitingPollViewEncoded" } ] } }, "required": [ "repository", "loop", "item", "reason" ], "additionalProperties": false }, "_usine_orchestrator_AwaitingPollViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AwaitingPoll" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_QueuedForWorkerViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "QueuedForWorker" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, "ahead": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "priority": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "creating": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_MachineViewEncoded" }, { "type": "null" } ] } }, "required": [ "_tag", "run", "ahead", "priority", "creating" ], "additionalProperties": false }, "_usine_orchestrator_WaitingForStopViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WaitingForStop" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, "stop": { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopViewEncoded" } }, "required": [ "_tag", "run", "stop" ], "additionalProperties": false }, "_usine_orchestrator_UnconfirmedStopViewEncoded": { "type": "object", "properties": { "runId": { "type": "string", "minLength": 1 }, "attemptNumber": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "runId", "attemptNumber", "worker" ], "additionalProperties": false }, "_usine_orchestrator_LoopPausedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "LoopPaused" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_ClosedUnchangedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ClosedUnchanged" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "required": [ "_tag", "run" ], "additionalProperties": false }, "_usine_orchestrator_RunFailedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RunFailed" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "required": [ "_tag", "run" ], "additionalProperties": false }, "_usine_orchestrator_CycleBudgetUsedUpViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "CycleBudgetUsedUp" ] }, "ask": { "$ref": "#/components/schemas/CycleBudgetAskEncoded" } }, "required": [ "_tag", "ask" ], "additionalProperties": false }, "CycleBudgetAskEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "itemKey": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "loop": { "type": "string", "minLength": 1 }, "limit": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "counts": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/LoopCycleCountEncoded" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/LoopCycleCountEncoded" } }, "blocks": { "type": "array", "items": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "eventId": { "type": "string", "minLength": 1 } }, "required": [ "loop", "eventId" ], "propertyNames": { "anyOf": [ { "enum": [ "loop", "eventId" ] }, { "type": "string" } ] }, "additionalProperties": false } } }, "required": [ "id", "itemKey", "repository", "loop", "limit", "counts" ], "propertyNames": { "anyOf": [ { "enum": [ "id", "itemKey", "repository", "loop", "limit", "counts", "blocks" ] }, { "type": "string" } ] }, "additionalProperties": false }, "LoopCycleCountEncoded": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "admitted": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "completed": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "loop", "admitted", "completed" ], "propertyNames": { "anyOf": [ { "enum": [ "loop", "admitted", "completed" ] }, { "type": "string" } ] }, "additionalProperties": false }, "_usine_orchestrator_SuppressedForOperatorViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SuppressedForOperator" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "required": [ "_tag", "run" ], "additionalProperties": false }, "_usine_orchestrator_AwaitingApprovalViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "AwaitingApproval" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "required": [ "_tag", "run" ], "additionalProperties": false }, "_usine_orchestrator_WaitingForUpgradeViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WaitingForUpgrade" ] }, "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, "wait": { "$ref": "#/components/schemas/_usine_engine_UpgradeWaitEncoded" } }, "required": [ "_tag", "run", "wait" ], "additionalProperties": false }, "_usine_engine_UpgradeWaitEncoded": { "type": "object", "properties": { "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "since": { "type": "string" } }, "required": [ "target", "since" ], "additionalProperties": false }, "_usine_orchestrator_RunningAttemptViewEncoded": { "type": "object", "properties": { "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, "attempt": { "$ref": "#/components/schemas/_usine_orchestrator_AttemptSummaryViewEncoded" }, "item": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_BoardItemLinkEncoded" }, { "type": "null" } ] }, "lastActivityAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "warnings": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_WorkerSilentViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProviderRetryingViewEncoded" } ] } } }, "required": [ "run", "attempt", "item", "lastActivityAt", "warnings" ], "additionalProperties": false }, "_usine_orchestrator_ProviderRetryingViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ProviderRetrying" ] }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string", "minLength": 1 }, "retries": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "since": { "type": "string" } }, "required": [ "_tag", "agent", "message", "retries", "since" ], "additionalProperties": false }, "_usine_orchestrator_WorkerSilentViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerSilent" ] }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "lastAnsweredAt": { "type": "string" } }, "required": [ "_tag", "worker", "lastAnsweredAt" ], "additionalProperties": false }, "_usine_orchestrator_ConfigurationViewEncoded": { "type": "object", "properties": { "projects": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "pattern": "\\S" }, "repositories": { "type": "array", "prefixItems": [ { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } ], "minItems": 1, "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, "lanes": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "\\S" }, "sources": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "label": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "required": [ "label" ], "additionalProperties": false }, { "type": "object", "properties": { "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] } }, "required": [ "state" ], "additionalProperties": false } ] }, "minItems": 1 } }, "required": [ "name", "sources" ], "additionalProperties": false } } }, "required": [ "id", "name", "repositories" ], "additionalProperties": false } }, "bindings": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "member": { "type": "integer", "maximum": 9007199254740991, "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": [ "admin", "viewer", "operator", "maintainer" ] }, "scope": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Instance" ] } }, "required": [ "_tag" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Project" ] }, "project": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "_tag", "project" ], "additionalProperties": false } ] } }, "required": [ "name", "member", "role", "scope" ], "additionalProperties": false } }, "labels": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_config_DeclaredLabelEncoded" } }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopFileViewEncoded" } }, "quarantinedLoops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_QuarantinedLoopViewEncoded" } }, "agents": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AgentFileViewEncoded" } }, "invalidAgents": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_InvalidAgentViewEncoded" } }, "workers": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_WorkerConfigurationViewEncoded" } }, "removedWorkers": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RemovedWorkerViewEncoded" } }, "repositories": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RepositoryConfigurationViewEncoded" } }, "settings": { "$ref": "#/components/schemas/_usine_orchestrator_SettingsViewEncoded" } }, "required": [ "labels", "loops", "quarantinedLoops", "agents", "invalidAgents", "workers", "removedWorkers", "repositories", "settings" ], "additionalProperties": false }, "_usine_orchestrator_SettingsViewEncoded": { "type": "object", "properties": { "pollInterval": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "maxChildren": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "maxAttemptMinutes": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "maxAttemptTokens": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "maxBackgroundWaitMinutes": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "parentModel": { "anyOf": [ { "type": "string", "pattern": "\\S" }, { "type": "null" } ] }, "parentEffort": { "anyOf": [ { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] }, { "type": "null" } ] }, "coordinator": { "type": "string", "enum": [ "session", "events" ] }, "supervisor": { "anyOf": [ { "type": "object", "properties": { "harness": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "model": { "type": "string", "pattern": "\\S" }, "effort": { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] }, "ownTools": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "unavailable": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] } }, "required": [ "harness", "model", "effort", "ownTools", "unavailable" ], "additionalProperties": false }, { "type": "null" } ] }, "operator": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "null" } ] }, "webhooks": { "type": "string", "enum": [ "off", "deliveries", "endpoint" ] }, "webhooksPublicUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "lastHintAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tracing": { "anyOf": [ { "type": "object", "properties": { "otlpUrl": { "type": "string" }, "serviceName": { "type": "string" } }, "required": [ "otlpUrl", "serviceName" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "pollInterval", "maxChildren", "maxAttemptMinutes", "maxAttemptTokens", "maxBackgroundWaitMinutes", "parentModel", "parentEffort", "coordinator", "supervisor", "operator", "webhooks", "webhooksPublicUrl", "lastHintAt", "tracing" ], "additionalProperties": false }, "_usine_orchestrator_RepositoryConfigurationViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "tags": { "type": "array", "items": { "type": "string", "pattern": "\\S" } }, "lanes": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LaneConfigurationViewEncoded" } }, "declaredLabels": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LabelStateViewEncoded" } }, "loops": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "name", "tags", "lanes", "declaredLabels", "loops" ], "additionalProperties": false }, "_usine_orchestrator_LabelStateViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "onGitHub": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "color": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "declared": { "type": "boolean" }, "failure": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LabelPreflightFindingEncoded" }, { "type": "null" } ] } }, "required": [ "name", "onGitHub", "color", "description", "declared", "failure" ], "additionalProperties": false }, "_usine_orchestrator_LabelPreflightFindingEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "label": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "errorTag": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 } }, "required": [ "repository", "label", "errorTag", "message" ], "additionalProperties": false }, "_usine_orchestrator_LaneConfigurationViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "\\S" }, "sources": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LabelLaneSourceViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_StateLaneSourceViewEncoded" } ] } } }, "required": [ "name", "sources" ], "additionalProperties": false }, "_usine_orchestrator_StateLaneSourceViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "State" ] }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] } }, "required": [ "_tag", "state" ], "additionalProperties": false }, "_usine_orchestrator_LabelLaneSourceViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Label" ] }, "label": { "$ref": "#/components/schemas/_usine_orchestrator_LabelStateViewEncoded" } }, "required": [ "_tag", "label" ], "additionalProperties": false }, "_usine_orchestrator_RemovedWorkerViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "running": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "name", "running" ], "additionalProperties": false }, "_usine_orchestrator_WorkerConfigurationViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "kind": { "type": "string", "enum": [ "local", "exe.dev", "ssh", "cloudflare" ] }, "maxConcurrentAttempts": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "paused": { "type": "boolean" }, "destination": { "anyOf": [ { "type": "string", "pattern": "^(?:[A-Za-z0-9._-]+@)?(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|[0-9A-Fa-f]{0,4}(?::[0-9A-Fa-f]{0,4}){2,7})$" }, { "type": "null" } ] }, "port": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 65535 }, { "type": "null" } ] }, "identityFile": { "anyOf": [ { "type": "string", "pattern": "^(?:\\/|~\\/)[!-~]+$" }, { "type": "null" } ] }, "root": { "anyOf": [ { "type": "string", "pattern": "^(?:\\/[!-.0-~]+)+$" }, { "type": "null" } ] }, "gateway": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_GatewayViewEncoded" }, { "type": "null" } ] }, "container": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ContainerViewEncoded" }, { "type": "null" } ] }, "containerLimits": { "anyOf": [ { "$ref": "#/components/schemas/ContainerLimitsEncoded" }, { "type": "null" } ] }, "provisioner": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_HetznerProvisionerViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoatProvisionerViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoxdProvisionerViewEncoded" }, { "type": "null" } ] }, "machines": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_MachineViewEncoded" } }, "provisioning": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ProvisioningPauseViewEncoded" }, { "type": "null" } ] }, "slots": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_WorkerSlotsViewEncoded" }, { "type": "null" } ] }, "prerequisites": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_PassedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DegradedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DeferredCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedCheckViewEncoded" }, { "type": "null" } ] }, "preflightRunning": { "type": "boolean" }, "harnesses": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_HarnessPreflightViewEncoded" } }, "findings": { "type": "array", "items": { "type": "string" } } }, "required": [ "name", "kind", "maxConcurrentAttempts", "destination", "port", "identityFile", "root", "gateway", "container", "containerLimits", "provisioner", "machines", "provisioning", "slots", "prerequisites", "preflightRunning", "harnesses", "findings" ], "additionalProperties": false }, "_usine_orchestrator_HarnessPreflightViewEncoded": { "type": "object", "properties": { "harness": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "check": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_PassedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DegradedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DeferredCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedCheckViewEncoded" } ] } }, "required": [ "harness", "check" ], "additionalProperties": false }, "_usine_orchestrator_BoxdProvisionerViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "boxd" ] }, "tokenEnv": { "type": "string" }, "endpoint": { "anyOf": [ { "type": "string", "pattern": "^(?:https:\\/\\/(?:[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?|\\[[0-9a-f:.]+\\])|http:\\/\\/(?:localhost|127(?:\\.\\d{1,3}){3}|\\[::1\\]))(?::\\d{1,5})?$" }, { "type": "null" } ] }, "region": { "anyOf": [ { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,62}$" }, { "type": "null" } ] }, "size": { "anyOf": [ { "type": "string", "pattern": "^[1-9][0-9]{0,3}x[1-9][0-9]{0,5}$" }, { "type": "null" } ] }, "snapshot": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" }, "isolated": { "type": "boolean" }, "egress": { "anyOf": [ { "type": "array", "items": { "type": "string", "pattern": "^(?:none|(?:\\*\\.)?(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?|(?:(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])\\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\\/(?:3[0-2]|[12]?[0-9]))?)$" } }, { "type": "null" } ] }, "anthropicKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "openaiKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "_tag", "tokenEnv", "endpoint", "region", "size", "snapshot", "isolated", "egress", "anthropicKeyEnv", "openaiKeyEnv" ], "additionalProperties": false }, "_usine_orchestrator_BoatProvisionerViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "boat" ] }, "tokenEnv": { "type": "string" }, "size": { "type": "string", "enum": [ "small", "default", "large", "xlarge" ] }, "anthropicKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "openaiKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "_tag", "tokenEnv", "size", "anthropicKeyEnv", "openaiKeyEnv" ], "additionalProperties": false }, "_usine_orchestrator_HetznerProvisionerViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "hetzner" ] }, "tokenEnv": { "type": "string" }, "serverType": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" }, "location": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" }, "image": { "type": "string", "pattern": "^[!-~](?:[ -~]{0,253}[!-~])?$" }, "network": { "anyOf": [ { "type": "string", "pattern": "^[!-~](?:[ -~]{0,126}[!-~])?$" }, { "type": "null" } ] }, "firewall": { "anyOf": [ { "type": "string", "pattern": "^[!-~](?:[ -~]{0,126}[!-~])?$" }, { "type": "null" } ] }, "sshKey": { "type": "string", "pattern": "^[!-~](?:[ -~]{0,126}[!-~])?$" }, "sshUser": { "type": "string", "pattern": "^[a-z_][a-z0-9_-]{0,31}$" }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "anthropicKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "openaiKeyEnv": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "_tag", "tokenEnv", "serverType", "location", "image", "network", "firewall", "sshKey", "sshUser", "labels", "anthropicKeyEnv", "openaiKeyEnv" ], "additionalProperties": false }, "ContainerLimitsEncoded": { "type": "object", "properties": { "cpus": { "type": "number", "exclusiveMinimum": 0 }, "memoryMib": { "type": "integer", "minimum": 256, "maximum": 9007199254740991 }, "pids": { "type": "integer", "minimum": 64, "maximum": 9007199254740991 } }, "required": [ "cpus", "memoryMib", "pids" ], "additionalProperties": false }, "_usine_orchestrator_ContainerViewEncoded": { "type": "object", "properties": { "image": { "anyOf": [ { "type": "string", "pattern": "^[a-z0-9][A-Za-z0-9._/:@-]{0,254}$" }, { "type": "null" } ] }, "cpus": { "anyOf": [ { "type": "number", "exclusiveMinimum": 0 }, { "type": "null" } ] }, "memoryMib": { "anyOf": [ { "type": "integer", "minimum": 256, "maximum": 9007199254740991 }, { "type": "null" } ] }, "pids": { "anyOf": [ { "type": "integer", "minimum": 64, "maximum": 9007199254740991 }, { "type": "null" } ] }, "shmSizeMib": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, { "type": "null" } ] }, "tmpfsSizeMib": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "image", "cpus", "memoryMib", "pids", "shmSizeMib", "tmpfsSizeMib" ], "additionalProperties": false }, "_usine_orchestrator_GatewayViewEncoded": { "type": "object", "properties": { "domain": { "type": "string", "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" }, "destination": { "type": "string", "pattern": "^(?:[A-Za-z0-9._-]+@)?(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|[0-9A-Fa-f]{0,4}(?::[0-9A-Fa-f]{0,4}){2,7})$" }, "adminPort": { "type": "integer", "minimum": 1, "maximum": 65535 }, "adminTokenEnv": { "type": "string", "minLength": 1 }, "llmProviders": { "type": "array", "items": { "type": "string", "enum": [ "anthropic-messages", "openai-responses" ] } } }, "required": [ "domain", "destination", "adminPort", "adminTokenEnv", "llmProviders" ], "additionalProperties": false }, "_usine_orchestrator_InvalidAgentViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "file": { "type": "string", "minLength": 1 }, "error": { "$ref": "#/components/schemas/_usine_config_ConfigFileErrorEncoded" } }, "required": [ "name", "file", "error" ], "additionalProperties": false }, "_usine_config_ConfigFileErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ConfigFileError" ] }, "file": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "enum": [ "expression", "frontmatter", "read", "reference", "schema", "yaml" ] }, "expression": { "type": "string", "pattern": "\\S" }, "message": { "type": "string", "minLength": 1 }, "details": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "expression": { "type": "string", "pattern": "\\S" }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "path", "message" ], "additionalProperties": false } } }, "required": [ "_tag", "file", "stage", "message" ], "additionalProperties": false }, "_usine_orchestrator_AgentFileViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "file": { "type": "string", "minLength": 1 }, "harness": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "model": { "type": "string", "pattern": "\\S" }, "effort": { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] }, "parentModel": { "anyOf": [ { "type": "string", "pattern": "\\S" }, { "type": "null" } ] }, "parentEffort": { "anyOf": [ { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] }, { "type": "null" } ] }, "resolvedParentModel": { "anyOf": [ { "type": "string", "pattern": "\\S" }, { "type": "null" } ] }, "resolvedParentEffort": { "type": "string", "enum": [ "off", "minimal", "low", "medium", "high", "xhigh", "max" ] }, "coordinator": { "anyOf": [ { "type": "string", "enum": [ "session", "events" ] }, { "type": "null" } ] }, "resolvedCoordinator": { "type": "string", "enum": [ "session", "events" ] }, "persona": { "type": "string", "pattern": "\\S" }, "loops": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "name", "file", "harness", "model", "effort", "parentModel", "parentEffort", "resolvedParentModel", "resolvedParentEffort", "coordinator", "resolvedCoordinator", "persona", "loops" ], "additionalProperties": false }, "_usine_orchestrator_QuarantinedLoopViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "file": { "type": "string", "minLength": 1 }, "error": { "$ref": "#/components/schemas/_usine_config_ConfigFileErrorEncoded" } }, "required": [ "name", "file", "error" ], "additionalProperties": false }, "_usine_orchestrator_LoopFileViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "file": { "type": "string", "minLength": 1 }, "stream": { "type": "string", "enum": [ "issue", "pr", "schedule" ] }, "condition": { "type": "string", "pattern": "\\S" }, "cron": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "timeZone": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "selector": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LoopSelectorViewEncoded" }, { "type": "null" } ] }, "repositories": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, "approval": { "anyOf": [ { "type": "string", "enum": [ "none", "required" ] }, { "type": "string", "pattern": "\\S" } ] }, "maxCycles": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "permissions": { "type": "string", "enum": [ "write", "read" ] }, "priority": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "string", "pattern": "\\S" }, { "type": "null" } ] }, "step": { "type": "string", "minLength": 1 }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "prompt": { "type": "string", "pattern": "\\S" }, "paused": { "type": "boolean" }, "undeclaredLabels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "outcomeLabels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "uniqueItems": true }, "undeclaredOutcomeLabels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } } }, "required": [ "name", "file", "stream", "condition", "cron", "timeZone", "selector", "repositories", "approval", "maxCycles", "permissions", "priority", "step", "agent", "prompt", "paused", "undeclaredLabels", "outcomeLabels", "undeclaredOutcomeLabels" ], "additionalProperties": false }, "_usine_orchestrator_LoopSelectorViewEncoded": { "type": "object", "properties": { "repos": { "anyOf": [ { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, { "type": "null" } ] }, "tags": { "anyOf": [ { "type": "array", "items": { "type": "string", "pattern": "\\S" } }, { "type": "null" } ] } }, "required": [ "repos", "tags" ], "additionalProperties": false }, "_usine_config_DeclaredLabelEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "color": { "type": "string", "pattern": "^[0-9a-fA-F]{6}$" }, "description": { "type": "string", "maxLength": 100 } }, "required": [ "name" ], "additionalProperties": false }, "_usine_orchestrator_ValidationTimeoutRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "ValidationTimeoutError" ] }, "message": { "type": "string" }, "step": { "type": "string", "enum": [ "wait", "read", "parse", "restart", "coordinator-brains", "worker-preflight", "store", "apply" ] } }, "required": [ "error", "message", "step" ], "additionalProperties": false }, "_usine_orchestrator_FactoryConfigRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "FactoryConfigError" ] }, "message": { "type": "string" }, "file": { "type": "string", "minLength": 1 }, "stage": { "type": "string", "enum": [ "expression", "frontmatter", "read", "reference", "schema", "yaml" ] } }, "required": [ "error", "message", "file", "stage" ], "additionalProperties": false }, "ConfigurationInvalidRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "ConfigurationInvalid" ] }, "message": { "type": "string" }, "problems": { "type": "array", "prefixItems": [ { "type": "object", "properties": { "entity": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" }, "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "expression": { "type": "string", "pattern": "\\S" }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "entity", "path", "message" ], "additionalProperties": false } ], "minItems": 1, "items": { "type": "object", "properties": { "entity": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" }, "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "expression": { "type": "string", "pattern": "\\S" }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "entity", "path", "message" ], "additionalProperties": false } } }, "required": [ "error", "message", "problems" ], "additionalProperties": false }, "_usine_config_ConfigurationEntityKeyEncoded": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "settings", "worker", "repository", "project", "label", "loop", "agent", "binding" ] }, "identifier": { "type": "string", "minLength": 1 } }, "required": [ "kind", "identifier" ], "additionalProperties": false }, "_usine_orchestrator_ReloadPreflightRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "ReloadPreflightError" ] }, "message": { "type": "string" }, "agents": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "workers": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "cause": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerCapabilityError" ] }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "capability": { "type": "string", "enum": [ "machine", "toolchain", "memory", "disk", "harness-login", "credentials", "gateway", "container", "provider" ] }, "message": { "type": "string" } }, "required": [ "_tag", "worker", "capability", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ExecutorOperationError" ] }, "operation": { "type": "string", "enum": [ "preflight", "prepare", "launch", "cancel", "cleanup" ] }, "message": { "type": "string" } }, "required": [ "_tag", "operation", "message" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "CredentialUnavailableError" ] }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "message": { "type": "string" } }, "required": [ "_tag", "repository", "message" ], "additionalProperties": false } ] } }, "required": [ "error", "message", "agents", "workers", "cause" ], "additionalProperties": false }, "_usine_orchestrator_RestartRequiredRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "RestartRequiredError" ] }, "message": { "type": "string" }, "blocks": { "type": "array", "prefixItems": [ { "type": "string", "enum": [ "workers", "tracing", "auth" ] } ], "minItems": 1, "items": { "type": "string", "enum": [ "workers", "tracing", "auth" ] } }, "fields": { "type": "array", "prefixItems": [ { "type": "string", "minLength": 1 } ], "minItems": 1, "items": { "type": "string", "minLength": 1 } } }, "required": [ "error", "message", "blocks", "fields" ], "additionalProperties": false }, "ConfigurationRevertRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "ConfigurationRevertBlocked" ] }, "message": { "type": "string" }, "entities": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" } } }, "required": [ "error", "message", "entities" ], "additionalProperties": false }, "StaleRevisionRefusalEncoded": { "type": "object", "properties": { "error": { "type": "string", "enum": [ "StaleRevision" ] }, "message": { "type": "string" }, "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "current": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "error", "message", "expected", "current" ], "additionalProperties": false }, "ConfigurationRevisionViewEncoded": { "type": "object", "properties": { "number": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "actor": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] }, "time": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "entities": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" } }, "changes": { "type": "array", "items": { "type": "object", "properties": { "key": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" }, "before": { "anyOf": [ {}, { "type": "null" } ] }, "after": { "anyOf": [ {}, { "type": "null" } ] }, "position": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "key", "before", "after" ], "additionalProperties": false } } }, "required": [ "number", "actor", "time", "message", "entities", "changes" ], "additionalProperties": false }, "ConfigurationWriteEncoded": { "type": "object", "properties": { "expected": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "message": { "type": "string" } }, "required": [ "expected" ], "additionalProperties": false }, "ConfigurationEntityViewEncoded": { "type": "object", "properties": { "key": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" }, "value": {}, "text": { "type": "string" }, "number": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "key", "value", "text", "number" ], "additionalProperties": false }, "ConfigurationRevisionPageEncoded": { "type": "object", "properties": { "revisions": { "type": "array", "items": { "$ref": "#/components/schemas/ConfigurationRevisionSummaryEncoded" } }, "nextBefore": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "revisions", "nextBefore" ], "additionalProperties": false }, "ConfigurationRevisionSummaryEncoded": { "type": "object", "properties": { "number": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "actor": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$" }, { "type": "string", "enum": [ "local admin" ] }, { "type": "null" } ] }, "time": { "type": "string" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "entities": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_config_ConfigurationEntityKeyEncoded" } } }, "required": [ "number", "actor", "time", "message", "entities" ], "additionalProperties": false }, "_usine_github_RepositoryLabelEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "color": { "type": "string", "pattern": "^[0-9a-fA-F]{6}$" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "color", "description" ], "additionalProperties": false }, "_usine_agents_HarnessPresentationEncoded": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "label": { "type": "string", "minLength": 1 }, "handoff": { "anyOf": [ { "$ref": "#/components/schemas/_usine_agents_ResumeCommandEncoded" }, { "type": "null" } ] }, "ownTools": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] } }, "required": [ "id", "label", "handoff", "ownTools" ], "additionalProperties": false }, "_usine_agents_ResumeCommandEncoded": { "type": "object", "properties": { "command": { "type": "string", "minLength": 1 }, "homeVariable": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "gateway": { "type": "boolean" } }, "required": [ "command", "homeVariable", "gateway" ], "additionalProperties": false }, "LoopPreviewEncoded": { "type": "object", "properties": { "stream": { "type": "string", "enum": [ "issue", "pr", "schedule" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/LoopPreviewItemEncoded" } }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "prompt": { "anyOf": [ { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "text": { "type": "string" } }, "required": [ "itemKey", "text" ], "additionalProperties": false }, { "type": "null" } ] }, "repositoriesWithoutItems": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, "failures": { "type": "array", "items": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "itemKey", "message" ], "additionalProperties": false } } }, "required": [ "stream", "items", "total", "prompt", "repositoriesWithoutItems", "failures" ], "additionalProperties": false }, "LoopPreviewItemEncoded": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "priority": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "itemKey", "repository", "kind", "number", "title", "url", "state", "priority" ], "additionalProperties": false }, "LoopPreviewRequestEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*\\/)?[a-z0-9]+(?:-[a-z0-9]+)*$" }, "value": {}, "itemKey": { "type": "string", "minLength": 1 } }, "required": [ "name", "value" ], "additionalProperties": false }, "LoopCheckEncoded": { "type": "object", "properties": { "problems": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "expression": { "type": "string", "pattern": "\\S" }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "path", "message" ], "additionalProperties": false } } }, "required": [ "problems" ], "additionalProperties": false }, "_usine_orchestrator_TaskViewEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "current": { "type": "string", "minLength": 1 }, "lane": { "$ref": "#/components/schemas/_usine_orchestrator_TaskLaneViewEncoded" }, "needsYou": { "type": "boolean" }, "items": { "type": "array", "prefixItems": [ { "$ref": "#/components/schemas/_usine_orchestrator_TaskItemViewEncoded" } ], "minItems": 1, "items": { "$ref": "#/components/schemas/_usine_orchestrator_TaskItemViewEncoded" } }, "runs": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RunViewEncoded" } }, "runsTotal": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "commentRuns": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "itemKey": { "type": "string", "minLength": 1 }, "loop": { "type": "string", "minLength": 1 } }, "required": [ "id", "repository", "itemKey", "loop" ], "additionalProperties": false } }, "comments": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TaskCommentViewEncoded" } }, "attemptChanges": { "type": "array", "items": { "type": "object", "properties": { "runId": { "type": "string", "minLength": 1 }, "attemptId": { "type": "string", "minLength": 1 }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "loop": { "type": "string", "minLength": 1 }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "base": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "runId", "attemptId", "number", "loop", "pullRequest", "base", "head" ], "additionalProperties": false } } }, "required": [ "repository", "number", "title", "current", "lane", "needsYou", "items", "runs", "comments" ], "additionalProperties": false }, "_usine_orchestrator_TaskCommentViewEncoded": { "type": "object", "properties": { "runId": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue-comment", "review", "review-comment" ] }, "url": { "type": "string" }, "postedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "attemptEndedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "runId", "kind", "url", "postedAt", "attemptEndedAt" ], "additionalProperties": false }, "_usine_orchestrator_RunViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "itemKey": { "type": "string", "minLength": 1 }, "loop": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "agentBrain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "state": { "type": "string", "enum": [ "Pending", "Waiting", "Queued", "Running", "AwaitingCi", "Succeeded", "HandedOff", "Failed", "Canceled" ] }, "ciWait": { "anyOf": [ { "type": "object", "properties": { "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "fixLoop": { "type": "string", "minLength": 1 }, "timeoutSeconds": { "type": "integer", "maximum": 86400, "exclusiveMinimum": 0 }, "onGreen": { "type": "array", "items": { "type": "object", "properties": { "item": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "add": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }, "remove": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true } }, "required": [ "item", "add", "remove" ], "additionalProperties": false } } }, "required": [ "pullRequest", "head", "fixLoop", "timeoutSeconds", "onGreen" ], "additionalProperties": false }, { "type": "null" } ] }, "handoff": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "HandedOff" ] }, "reason": { "type": "string", "minLength": 1 }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "fixLoop": { "type": "string", "minLength": 1 }, "fixRunId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "reason", "head", "fixLoop", "fixRunId" ], "additionalProperties": false }, { "type": "null" } ] }, "upgradeWait": { "anyOf": [ { "type": "object", "properties": { "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "since": { "type": "string" } }, "required": [ "target", "since" ], "additionalProperties": false }, { "type": "null" } ] }, "providerRetry": { "anyOf": [ { "type": "object", "properties": { "nextAttempt": { "type": "integer", "minimum": 2, "maximum": 9007199254740991 }, "retryAt": { "type": "string" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "nextAttempt", "retryAt", "message" ], "propertyNames": { "anyOf": [ { "enum": [ "nextAttempt", "retryAt", "message" ] }, { "type": "string" } ] }, "additionalProperties": false }, { "type": "null" } ] }, "machineWait": { "anyOf": [ { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string" } }, "required": [ "worker", "message" ], "additionalProperties": false }, { "type": "null" } ] }, "loopPaused": { "type": "boolean" }, "openedAt": { "type": "string" }, "closedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "task": { "type": "string" }, "attempts": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AttemptViewEncoded" } }, "approval": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalViewEncoded" }, { "type": "null" } ] }, "approvalReason": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "runAgain": { "anyOf": [ { "$ref": "#/components/schemas/RunAgainEncoded" }, { "type": "null" } ] }, "resultMessage": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "pullRequestUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "canApprove": { "type": "boolean" }, "canRetry": { "type": "boolean" }, "canResolveFailure": { "type": "boolean" }, "canApplyCiLabels": { "type": "boolean" }, "canCancel": { "type": "boolean" }, "canRunAgain": { "type": "boolean" } }, "required": [ "id", "itemKey", "loop", "repository", "agent", "agentBrain", "state", "loopPaused", "openedAt", "closedAt", "task", "attempts", "approval", "runAgain", "resultMessage", "pullRequestUrl", "canApprove", "canRetry", "canResolveFailure", "canCancel", "canRunAgain" ], "additionalProperties": false }, "_usine_orchestrator_AttemptViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "workerAccess": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LocalWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_SshWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProvisionedWorkerAccessEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_SandboxWorkerAccessEncoded" }, { "type": "null" } ] }, "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "task": { "type": "string", "pattern": "\\S" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "operatorIntervened": { "type": "boolean" }, "startedAt": { "type": "string" }, "outcome": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_SucceededAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AwaitingCiAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_HandedOffAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedAttemptViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_CanceledAttemptViewEncoded" }, { "type": "null" } ] }, "endedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "salvage": { "anyOf": [ { "$ref": "#/components/schemas/AttemptSalvage_PushedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_PartlyPushedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_RetainedEncoded" }, { "$ref": "#/components/schemas/AttemptSalvage_RejectedEncoded" }, { "type": "null" } ] }, "start": { "anyOf": [ { "$ref": "#/components/schemas/AttemptStart_EventEncoded" }, { "$ref": "#/components/schemas/AttemptStart_RetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_EditAndRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_InfraRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_ProviderRetryEncoded" }, { "$ref": "#/components/schemas/AttemptStart_AfterRestartEncoded" }, { "type": "null" } ] }, "reattachedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "outOfMemory": { "anyOf": [ { "$ref": "#/components/schemas/OutOfMemoryKillsEncoded" }, { "type": "null" } ] } }, "required": [ "id", "number", "worker", "workerAccess", "brain", "task", "agent", "operatorIntervened", "startedAt", "outcome", "endedAt", "salvage", "start", "reattachedAt", "outOfMemory" ], "additionalProperties": false }, "_usine_orchestrator_TaskItemViewEncoded": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" }, "pullRequest": { "anyOf": [ { "type": "object", "properties": { "base": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "checks": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "review": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "base", "head", "checks", "review" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting" ], "additionalProperties": false }, "_usine_orchestrator_TaskLaneViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "pattern": "\\S" } }, "required": [ "id", "name" ], "additionalProperties": false }, "_usine_orchestrator_WorkerPreflightViewEncoded": { "type": "object", "properties": { "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "prerequisites": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_PassedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DegradedCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DeferredCheckViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedCheckViewEncoded" }, { "type": "null" } ] }, "harnesses": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_HarnessPreflightViewEncoded" } }, "containerLimits": { "anyOf": [ { "$ref": "#/components/schemas/ContainerLimitsEncoded" }, { "type": "null" } ] }, "findings": { "type": "array", "items": { "type": "string" } } }, "required": [ "worker", "prerequisites", "harnesses", "containerLimits", "findings" ], "additionalProperties": false }, "FileChangesEncoded": { "type": "object", "properties": { "base": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/ChangedFileEncoded" } }, "filesTruncated": { "type": "boolean" } }, "required": [ "base", "head", "files", "filesTruncated" ], "additionalProperties": false }, "ChangedFileEncoded": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1 }, "oldPath": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "added", "modified", "removed", "renamed" ] }, "additions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "deletions": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "patch": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "text" ] }, "text": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "kind", "text", "truncated" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "omitted" ] } }, "required": [ "kind" ], "additionalProperties": false } ] }, "test": { "type": "boolean" }, "generated": { "type": "boolean" } }, "required": [ "path", "oldPath", "status", "additions", "deletions", "patch", "test", "generated" ], "additionalProperties": false }, "_usine_orchestrator_BoardTaskViewEncoded": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BoardItemLinkEncoded" }, "minItems": 1 }, "pullRequest": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_BoardPullRequestViewEncoded" }, { "type": "null" } ] }, "runCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "attemptCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "runContext": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "loopStates": { "type": "array", "items": { "type": "object", "properties": { "loop": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "Pending", "Waiting", "Queued", "Running", "AwaitingCi", "Succeeded", "HandedOff", "Failed", "Canceled" ] } }, "required": [ "loop", "state" ], "additionalProperties": false } }, "run": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" }, { "type": "null" } ] }, "needsYou": { "type": "boolean" }, "loops": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "usage": { "$ref": "#/components/schemas/_usine_orchestrator_TaskUsageViewEncoded" } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting", "repository", "items", "pullRequest", "runCount", "attemptCount", "runContext", "loopStates", "run", "needsYou", "loops", "usage" ], "additionalProperties": false }, "_usine_orchestrator_TaskUsageViewEncoded": { "type": "object", "properties": { "durationMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "runningSince": { "type": "array", "items": { "type": "string" } }, "unmeasured": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pools": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TaskPoolUsageViewEncoded" } }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UsageCostViewEncoded" }, { "type": "null" } ] } }, "required": [ "durationMillis", "runningSince", "unmeasured", "tokens", "pools", "cost" ], "additionalProperties": false }, "_usine_orchestrator_UsageCostViewEncoded": { "type": "object", "properties": { "usd": { "type": "number", "minimum": 0 }, "estimate": { "type": "boolean" } }, "required": [ "usd", "estimate" ], "additionalProperties": false }, "_usine_orchestrator_TaskPoolUsageViewEncoded": { "type": "object", "properties": { "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UsageCostViewEncoded" }, { "type": "null" } ] }, "unpriced": { "type": "boolean" } }, "required": [ "pool", "tokens", "cost", "unpriced" ], "additionalProperties": false }, "_usine_orchestrator_BoardPullRequestViewEncoded": { "type": "object", "properties": { "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "pr-open", "pr-merged" ] } }, "required": [ "number", "url", "state" ], "additionalProperties": false }, "_usine_orchestrator_ProjectViewEncoded": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string" }, "repositories": { "type": "array", "items": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "status": { "type": "string", "enum": [ "clear", "active", "needs-you" ] }, "runs": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_RunSummaryViewEncoded" } }, "board": { "$ref": "#/components/schemas/_usine_orchestrator_BoardViewEncoded" }, "labels": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LabelViewEncoded" } }, "preflightFindings": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LabelPreflightFindingEncoded" } } }, "required": [ "repository", "status", "runs", "board", "labels", "preflightFindings" ], "additionalProperties": false }, "_usine_orchestrator_LabelViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "color": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "color", "description" ], "additionalProperties": false }, "_usine_orchestrator_BoardViewEncoded": { "type": "object", "properties": { "lanes": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_WritableBoardLaneViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReadOnlyBoardLaneViewEncoded" } ] } }, "cardedItemKeys": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "failures": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionErrorEncoded" } } }, "required": [ "lanes", "failures" ], "additionalProperties": false }, "_usine_orchestrator_BoardProjectionErrorEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "BoardProjectionError" ] }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "itemKey": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "repository", "itemKey", "message" ], "additionalProperties": false }, "_usine_orchestrator_ReadOnlyBoardLaneViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ReadOnlyBoardLane" ] }, "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "pattern": "\\S" }, "sources": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_config_LabelLaneSourceEncoded" }, { "$ref": "#/components/schemas/_usine_config_StateLaneSourceEncoded" } ] } }, "origin": { "type": "string", "enum": [ "authored", "proposed", "fallback" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BoardTaskViewEncoded" } }, "totalItems": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "_tag", "id", "name", "sources", "origin", "items" ], "additionalProperties": false }, "_usine_config_StateLaneSourceEncoded": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] } }, "required": [ "state" ], "additionalProperties": false }, "_usine_config_LabelLaneSourceEncoded": { "type": "object", "properties": { "label": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "required": [ "label" ], "additionalProperties": false }, "_usine_orchestrator_WritableBoardLaneViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WritableBoardLane" ] }, "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "pattern": "\\S" }, "sources": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_config_LabelLaneSourceEncoded" }, { "$ref": "#/components/schemas/_usine_config_StateLaneSourceEncoded" } ] } }, "origin": { "type": "string", "enum": [ "authored" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_BoardTaskViewEncoded" } }, "totalItems": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 }, "minItems": 1 } }, "required": [ "_tag", "id", "name", "sources", "origin", "items", "labels" ], "additionalProperties": false }, "_usine_orchestrator_RunGitHubChangesViewEncoded": { "type": "object", "properties": { "attempts": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_AttemptGitHubChangesViewEncoded" } } }, "required": [ "attempts" ], "additionalProperties": false }, "_usine_orchestrator_AttemptGitHubChangesViewEncoded": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "changes": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_LabelAddedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_LabelRemovedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_CommentedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ReviewedViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoardMovedViewEncoded" } ] } } }, "required": [ "attemptId", "changes" ], "additionalProperties": false }, "_usine_orchestrator_BoardMovedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "BoardMoved" ] }, "at": { "type": "string" }, "fromLane": { "type": "string", "pattern": "\\S" }, "toLane": { "type": "string", "pattern": "\\S" } }, "required": [ "_tag", "at", "fromLane", "toLane" ], "additionalProperties": false }, "_usine_orchestrator_ReviewedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Reviewed" ] }, "at": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string", "enum": [ "APPROVED", "CHANGES_REQUESTED", "COMMENTED", "DISMISSED" ] } }, "required": [ "_tag", "at", "url", "state" ], "additionalProperties": false }, "_usine_orchestrator_CommentedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Commented" ] }, "at": { "type": "string" }, "url": { "type": "string" } }, "required": [ "_tag", "at", "url" ], "additionalProperties": false }, "_usine_orchestrator_LabelRemovedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "LabelRemoved" ] }, "at": { "type": "string" }, "label": { "$ref": "#/components/schemas/_usine_orchestrator_LabelViewEncoded" } }, "required": [ "_tag", "at", "label" ], "additionalProperties": false }, "_usine_orchestrator_LabelAddedViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "LabelAdded" ] }, "at": { "type": "string" }, "label": { "$ref": "#/components/schemas/_usine_orchestrator_LabelViewEncoded" } }, "required": [ "_tag", "at", "label" ], "additionalProperties": false }, "_usine_orchestrator_RunDetailViewEncoded": { "type": "object", "properties": { "run": { "$ref": "#/components/schemas/_usine_orchestrator_RunViewEncoded" }, "agentDefinitionChanged": { "type": "boolean" }, "eventDedupKey": { "type": "string" }, "eventPayload": {}, "transcript": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TranscriptEventViewEncoded" } }, "sessionState": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TranscriptEventViewEncoded" } }, "earlierTranscript": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_TranscriptPageCursorEncoded" } }, "worker": { "anyOf": [ { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, { "type": "null" } ] }, "settledItemState": { "anyOf": [ { "type": "string", "enum": [ "issue-closed", "pr-closed", "pr-merged" ] }, { "type": "null" } ] }, "duration": { "$ref": "#/components/schemas/_usine_orchestrator_RunDurationViewEncoded" }, "usage": { "$ref": "#/components/schemas/_usine_orchestrator_RunUsageViewEncoded" }, "unconfirmedStop": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopViewEncoded" }, { "type": "null" } ] }, "machine": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_MachineViewEncoded" }, { "type": "null" } ] } }, "required": [ "run", "agentDefinitionChanged", "eventDedupKey", "eventPayload", "transcript", "sessionState", "earlierTranscript", "worker", "settledItemState", "duration", "usage", "unconfirmedStop", "machine" ], "additionalProperties": false }, "_usine_orchestrator_RunUsageViewEncoded": { "type": "object", "properties": { "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "pools": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_PoolUsageViewEncoded" } }, "sessions": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_SessionUsageViewEncoded" } } }, "required": [ "tokens", "pools", "sessions" ], "additionalProperties": false }, "_usine_orchestrator_SessionUsageViewEncoded": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UsageCostViewEncoded" }, { "type": "null" } ] } }, "required": [ "attemptId", "session", "pool", "tokens", "cost" ], "additionalProperties": false }, "Agent_RoleSessionEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RoleSession" ] }, "id": { "type": "string", "minLength": 1 }, "role": { "type": "string", "minLength": 1, "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "parentId": { "type": "string", "minLength": 1 }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "endpoint": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "id", "role", "agent", "brain" ], "additionalProperties": false }, "Agent_ChildSessionEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ChildSession" ] }, "id": { "type": "string", "minLength": 1 }, "parentId": { "type": "string", "minLength": 1 }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "endpoint": { "type": "string", "minLength": 1 }, "gatewayCredential": { "type": "string", "enum": [ "api-key", "subscription" ] } }, "required": [ "_tag", "id", "parentId", "agent", "brain" ], "additionalProperties": false }, "Agent_ParentSessionEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ParentSession" ] }, "id": { "type": "string", "minLength": 1 }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "brain": { "$ref": "#/components/schemas/Agent_BrainSpecEncoded" }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "endpoint": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "id", "agent", "brain" ], "additionalProperties": false }, "_usine_orchestrator_PoolUsageViewEncoded": { "type": "object", "properties": { "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "tokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cost": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UsageCostViewEncoded" }, { "type": "null" } ] } }, "required": [ "pool", "tokens", "cost" ], "additionalProperties": false }, "_usine_orchestrator_RunDurationViewEncoded": { "type": "object", "properties": { "endedMillis": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "runningSince": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "unmeasured": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "endedMillis", "runningSince", "unmeasured" ], "additionalProperties": false }, "_usine_orchestrator_TranscriptPageCursorEncoded": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "before": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "attemptId", "before" ], "additionalProperties": false }, "_usine_orchestrator_TranscriptEventViewEncoded": { "type": "object", "properties": { "sequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "attemptId": { "type": "string", "minLength": 1 }, "receivedAt": { "type": "string" }, "direction": { "type": "string", "enum": [ "inbound", "outbound" ] }, "target": { "anyOf": [ { "$ref": "#/components/schemas/AttemptChannel_ParentTargetEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_ChildTargetEncoded" } ] }, "operator": { "type": "string", "minLength": 1 }, "payload": { "anyOf": [ { "$ref": "#/components/schemas/AttemptChannel_StartedEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_SessionEventEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_FinalEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_FailedTranscriptViewEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterruptedEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_SteerEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterruptEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_OperatorMessageEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_ReleaseEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_CancelEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterventionAppliedEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterventionRejectedEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_WorkerUnresponsiveEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_WorkerResponsiveEncoded" } ] } }, "required": [ "sequence", "attemptId", "receivedAt", "direction", "payload" ], "additionalProperties": false }, "AttemptChannel_WorkerResponsiveEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerResponsive" ] }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "lastAnsweredAt": { "type": "string" }, "recovered": { "type": "boolean" } }, "required": [ "_tag", "worker", "lastAnsweredAt" ], "additionalProperties": false }, "AttemptChannel_WorkerUnresponsiveEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerUnresponsive" ] }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "lastAnsweredAt": { "type": "string" }, "reason": { "type": "string", "minLength": 1 }, "unansweredProbes": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "_tag", "worker", "lastAnsweredAt", "reason" ], "additionalProperties": false }, "AttemptChannel_InterventionRejectedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "InterventionRejected" ] }, "inputSequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "intervention": { "$ref": "#/components/schemas/AttemptChannel_InterventionEncoded" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "inputSequence", "intervention", "message" ], "additionalProperties": false }, "AttemptChannel_InterventionEncoded": { "type": "object", "properties": { "operator": { "type": "string", "minLength": 1 }, "target": { "anyOf": [ { "$ref": "#/components/schemas/AttemptChannel_ParentTargetEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_ChildTargetEncoded" } ] }, "action": { "anyOf": [ { "$ref": "#/components/schemas/AttemptChannel_SteerEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterruptEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_OperatorMessageEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_ReleaseEncoded" } ] } }, "required": [ "operator", "target", "action" ], "additionalProperties": false }, "AttemptChannel_ReleaseEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Release" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptChannel_OperatorMessageEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "OperatorMessage" ] }, "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "AttemptChannel_InterruptEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Interrupt" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptChannel_SteerEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Steer" ] }, "id": { "type": "string", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$", "format": "uuid" }, "message": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "message" ], "additionalProperties": false }, "AttemptChannel_ChildTargetEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Child" ] }, "sessionId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "sessionId" ], "additionalProperties": false }, "AttemptChannel_ParentTargetEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Parent" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptChannel_InterventionAppliedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "InterventionApplied" ] }, "inputSequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "intervention": { "$ref": "#/components/schemas/AttemptChannel_InterventionEncoded" }, "state": { "$ref": "#/components/schemas/AttemptChannel_InterventionStateEncoded" } }, "required": [ "_tag", "inputSequence", "intervention", "state" ], "additionalProperties": false }, "AttemptChannel_InterventionStateEncoded": { "type": "object", "properties": { "held": { "type": "boolean" }, "paused": { "type": "boolean" }, "queued": { "type": "boolean" }, "forwardedTo": { "type": "string", "minLength": 1 } }, "required": [ "held", "paused" ], "additionalProperties": false }, "AttemptChannel_CancelEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Cancel" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "AttemptChannel_InterruptedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Interrupted" ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_FailedTranscriptViewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Failed" ] }, "failure": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_GitHubPushFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_InfraFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProviderCapacityFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DefectFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AgentFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BlockedFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_QuestionFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunawayFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ChildSessionBudgetFailureViewEncoded" } ] } }, "required": [ "_tag", "failure" ], "additionalProperties": false }, "AttemptChannel_FinalEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Final" ] }, "result": { "$ref": "#/components/schemas/StepResultEncoded" } }, "required": [ "_tag", "result" ], "additionalProperties": false }, "StepResultEncoded": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 }, "facts": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/StepResult_CommitEncoded" }, { "$ref": "#/components/schemas/StepResult_PullRequestEncoded" }, { "$ref": "#/components/schemas/StepResult_CommentEncoded" } ] } }, "unverifiedHandoff": { "anyOf": [ { "$ref": "#/components/schemas/HeadMismatchEncoded" }, { "$ref": "#/components/schemas/PullRequestNotFoundEncoded" }, { "$ref": "#/components/schemas/PullRequestNotOpenEncoded" }, { "$ref": "#/components/schemas/RepositoryMismatchEncoded" }, { "$ref": "#/components/schemas/BranchNotAtHeadEncoded" }, { "$ref": "#/components/schemas/GitHubReadFailedEncoded" }, { "$ref": "#/components/schemas/GitReadFailedEncoded" }, { "$ref": "#/components/schemas/VerificationTimedOutEncoded" } ] }, "outputs": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:[-_][a-z0-9]+)*$" }, "type": { "type": "string", "minLength": 1, "maxLength": 128 }, "commit": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "size": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "name", "type", "size", "sha256" ], "additionalProperties": false } } }, "required": [ "message", "facts" ], "additionalProperties": false }, "VerificationTimedOutEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "VerificationTimedOut" ] }, "seconds": { "type": "integer", "maximum": 9007199254740991, "exclusiveMinimum": 0 } }, "required": [ "_tag", "seconds" ], "additionalProperties": false }, "GitReadFailedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "GitReadFailed" ] }, "message": { "type": "string", "minLength": 1 }, "cause": {} }, "required": [ "_tag", "message", "cause" ], "additionalProperties": false }, "GitHubReadFailedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "GitHubReadFailed" ] }, "message": { "type": "string", "minLength": 1 }, "cause": {} }, "required": [ "_tag", "message" ], "additionalProperties": false }, "BranchNotAtHeadEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "BranchNotAtHead" ] }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "branch": { "type": "string", "minLength": 1 }, "branchHead": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "branch", "head" ], "additionalProperties": false }, "RepositoryMismatchEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RepositoryMismatch" ] }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "headRepository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" } }, "required": [ "_tag", "pullRequest" ], "additionalProperties": false }, "PullRequestNotOpenEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PullRequestNotOpen" ] }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "state": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "pullRequest", "state" ], "additionalProperties": false }, "PullRequestNotFoundEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PullRequestNotFound" ] }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "branch": { "type": "string", "minLength": 1 }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "head" ], "additionalProperties": false }, "HeadMismatchEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "HeadMismatch" ] }, "pullRequest": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "handedOff": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "pullRequest", "handedOff", "head" ], "additionalProperties": false }, "StepResult_CommentEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Comment" ] }, "url": { "type": "string" }, "kind": { "type": "string", "enum": [ "issue-comment", "review", "review-comment" ] }, "at": { "type": "string" } }, "required": [ "_tag", "url", "kind" ], "additionalProperties": false }, "StepResult_PullRequestEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PullRequest" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "url": { "type": "string" }, "base": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "head": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "number", "url" ], "additionalProperties": false }, "StepResult_CommitEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Commit" ] }, "sha": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" }, "summary": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "sha", "summary" ], "additionalProperties": false }, "AttemptChannel_SessionEventEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionEvent" ] }, "event": { "anyOf": [ { "$ref": "#/components/schemas/Agent_SessionStartedEncoded" }, { "$ref": "#/components/schemas/Agent_TextOutputEncoded" }, { "$ref": "#/components/schemas/Agent_ToolStartedEncoded" }, { "$ref": "#/components/schemas/Agent_ToolFinishedEncoded" }, { "$ref": "#/components/schemas/Agent_PoolRateLimitsUpdatedEncoded" }, { "$ref": "#/components/schemas/Agent_SessionFinishedEncoded" }, { "$ref": "#/components/schemas/Agent_SessionIdleEncoded" }, { "$ref": "#/components/schemas/Agent_SessionResumedEncoded" }, { "$ref": "#/components/schemas/Agent_SessionTokensUpdatedEncoded" }, { "$ref": "#/components/schemas/Agent_ProviderRetryingEncoded" }, { "$ref": "#/components/schemas/Agent_ProviderRecoveredEncoded" } ] } }, "required": [ "_tag", "event" ], "additionalProperties": false }, "Agent_ProviderRecoveredEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ProviderRecovered" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "retries": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "_tag", "session", "retries" ], "additionalProperties": false }, "Agent_ProviderRetryingEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ProviderRetrying" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "message": { "type": "string", "minLength": 1 }, "retries": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "_tag", "session", "message", "retries" ], "additionalProperties": false }, "Agent_SessionTokensUpdatedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionTokensUpdated" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "totalTokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "costUsd": { "type": "number", "minimum": 0 }, "breakdown": { "type": "object", "properties": { "input": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cachedInput": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "cacheWrite": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "output": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "input", "cachedInput", "cacheWrite", "output" ], "additionalProperties": false }, "processUsage": { "type": "object", "properties": { "totalTokens": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "costUsd": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] }, "messages": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "awaitsFirstResult": { "type": "boolean" } }, "required": [ "totalTokens", "costUsd" ], "additionalProperties": false } }, "required": [ "_tag", "session", "totalTokens" ], "additionalProperties": false }, "Agent_SessionResumedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionResumed" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] } }, "required": [ "_tag", "session" ], "additionalProperties": false }, "Agent_SessionIdleEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionIdle" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "message": { "type": "string", "minLength": 1 }, "answeredOperator": { "type": "boolean" } }, "required": [ "_tag", "session" ], "additionalProperties": false }, "Agent_SessionFinishedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionFinished" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "backgroundWaitLimitPassed": { "type": "boolean" } }, "required": [ "_tag", "session" ], "additionalProperties": false }, "Agent_PoolRateLimitsUpdatedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PoolRateLimitsUpdated" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "login": { "type": "string", "minLength": 1 }, "rateLimits": { "$ref": "#/components/schemas/Agent_RateLimitsSnapshotEncoded" } }, "required": [ "_tag", "session", "pool", "rateLimits" ], "additionalProperties": false }, "Agent_RateLimitsSnapshotEncoded": { "type": "object", "properties": { "limitId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "limitName": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "primary": { "anyOf": [ { "$ref": "#/components/schemas/Agent_RateLimitWindowEncoded" }, { "type": "null" } ] }, "secondary": { "anyOf": [ { "$ref": "#/components/schemas/Agent_RateLimitWindowEncoded" }, { "type": "null" } ] } }, "required": [ "limitId", "limitName", "primary", "secondary" ], "additionalProperties": false }, "Agent_RateLimitWindowEncoded": { "type": "object", "properties": { "usedPercent": { "type": "number" }, "windowDurationMinutes": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "resetsAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "usedPercent", "windowDurationMinutes", "resetsAt" ], "additionalProperties": false }, "Agent_ToolFinishedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ToolFinished" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "callId": { "type": "string", "minLength": 1 }, "tool": { "type": "string", "minLength": 1 }, "output": {}, "isError": { "type": "boolean" } }, "required": [ "_tag", "session", "callId", "tool", "output", "isError" ], "additionalProperties": false }, "Agent_ToolStartedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ToolStarted" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "callId": { "type": "string", "minLength": 1 }, "tool": { "type": "string", "minLength": 1 }, "input": {} }, "required": [ "_tag", "session", "callId", "tool", "input" ], "additionalProperties": false }, "Agent_TextOutputEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "TextOutput" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "text": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "session", "text" ], "additionalProperties": false }, "Agent_SessionStartedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "SessionStarted" ] }, "session": { "anyOf": [ { "$ref": "#/components/schemas/Agent_ParentSessionEncoded" }, { "$ref": "#/components/schemas/Agent_ChildSessionEncoded" }, { "$ref": "#/components/schemas/Agent_RoleSessionEncoded" } ] }, "prompt": { "type": "string" }, "harnessSession": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "cwd": { "type": "string", "minLength": 1 }, "home": { "type": "string", "minLength": 1 }, "modelProvider": { "type": "string", "minLength": 1 } }, "required": [ "id", "cwd" ], "additionalProperties": false } }, "required": [ "_tag", "session" ], "additionalProperties": false }, "AttemptChannel_StartedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Started" ] }, "parentModel": { "anyOf": [ { "type": "string", "pattern": "\\S" }, { "type": "null" } ] }, "conflictingSalvage": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Pushed" ] }, "ref": { "type": "string", "minLength": 1 }, "commit": { "type": "string", "pattern": "^[0-9a-f]{40}(?:[0-9a-f]{24})?$" } }, "required": [ "_tag", "ref", "commit" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "_tag" ], "additionalProperties": false }, "_usine_orchestrator_CycleBudgetResetViewEncoded": { "type": "object", "properties": { "replayedCiFixEventIds": { "type": "array", "items": { "type": "string", "minLength": 1 } } }, "required": [ "replayedCiFixEventIds" ], "additionalProperties": false }, "_usine_orchestrator_SessionInterventionEncoded": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "target": { "anyOf": [ { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Parent" ] } }, "required": [ "_tag" ], "additionalProperties": false }, { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Child" ] }, "sessionId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "sessionId" ], "additionalProperties": false } ] }, "action": { "anyOf": [ { "$ref": "#/components/schemas/AttemptChannel_SteerEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_InterruptEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_OperatorMessageEncoded" }, { "$ref": "#/components/schemas/AttemptChannel_ReleaseEncoded" } ] } }, "required": [ "attemptId", "action" ], "additionalProperties": false }, "_usine_engine_CycleBlockedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "CycleBlocked" ] }, "eventId": { "type": "string", "minLength": 1 }, "ask": { "$ref": "#/components/schemas/CycleBudgetAskEncoded" } }, "required": [ "_tag", "eventId", "ask" ], "additionalProperties": false }, "_usine_engine_ClaimedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Claimed" ] }, "eventId": { "type": "string", "minLength": 1 }, "runId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "eventId", "runId" ], "additionalProperties": false }, "_usine_orchestrator_EditAndRetryEncoded": { "type": "object", "properties": { "task": { "type": "string", "pattern": "\\S" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "task", "agent" ], "additionalProperties": false }, "_usine_engine_AttentionKeyEncoded": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "revision": { "type": "string", "minLength": 1 } }, "required": [ "id", "revision" ], "additionalProperties": false }, "_usine_orchestrator_NeedsSetupOverviewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "NeedsSetup" ] }, "identities": { "type": "array", "items": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "items": { "type": "array", "items": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting" ], "additionalProperties": false }, "minItems": 1 } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting", "repository", "items" ], "additionalProperties": false } }, "errorTag": { "type": "string", "minLength": 1 }, "projects": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_ProjectViewEncoded" } }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopViewEncoded" } }, "needsYou": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeDrainNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WebhookSilenceNeedEncoded" }, { "$ref": "#/components/schemas/CycleBudgetNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PollFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PreflightFindingNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ConfigFileNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfiguredWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnresponsiveWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPreflightNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerQuotaNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPausedNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PoolLimitNeedEncoded" } ] } }, "dismissedNeeds": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeDrainNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WebhookSilenceNeedEncoded" }, { "$ref": "#/components/schemas/CycleBudgetNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PollFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PreflightFindingNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ConfigFileNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfiguredWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnresponsiveWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPreflightNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerQuotaNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPausedNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PoolLimitNeedEncoded" } ] } } }, "required": [ "_tag", "errorTag", "projects", "loops", "needsYou", "dismissedNeeds" ], "additionalProperties": false }, "_usine_orchestrator_PoolLimitNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PoolLimitNeed" ] }, "id": { "type": "string" }, "pool": { "type": "string", "enum": [ "apiKeys", "claudePlan", "chatgptPlan" ] }, "login": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "window": { "type": "string", "enum": [ "primary", "secondary" ] }, "usedPercent": { "type": "number", "minimum": 80 }, "resetsAt": { "type": "string" } }, "required": [ "_tag", "id", "pool", "login", "window", "usedPercent", "resetsAt" ], "additionalProperties": false }, "_usine_orchestrator_WorkerPausedNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerPausedNeed" ] }, "id": { "type": "string" }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "_tag", "id", "worker" ], "additionalProperties": false }, "_usine_orchestrator_WorkerQuotaNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerQuotaNeed" ] }, "id": { "type": "string" }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string" } }, "required": [ "_tag", "id", "worker", "message" ], "additionalProperties": false }, "_usine_orchestrator_WorkerPreflightNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WorkerPreflightNeed" ] }, "id": { "type": "string" }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string" } }, "required": [ "_tag", "id", "worker", "message" ], "additionalProperties": false }, "_usine_orchestrator_UnresponsiveWorkerNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "UnresponsiveWorkerNeed" ] }, "id": { "type": "string" }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "lastAnsweredAt": { "type": "string" }, "attempts": { "type": "array", "items": { "type": "object", "properties": { "attemptId": { "type": "string", "minLength": 1 }, "attemptNumber": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "runId": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "loop": { "type": "string", "minLength": 1 } }, "required": [ "attemptId", "attemptNumber", "runId", "repository", "loop" ], "additionalProperties": false }, "minItems": 1 } }, "required": [ "_tag", "id", "worker", "lastAnsweredAt", "attempts" ], "additionalProperties": false }, "_usine_orchestrator_UnconfirmedStopNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "UnconfirmedStopNeed" ] }, "id": { "type": "string" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "runId": { "type": "string", "minLength": 1 }, "loop": { "type": "string", "minLength": 1 }, "attemptNumber": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "_tag", "id", "repository", "runId", "loop", "attemptNumber", "worker" ], "additionalProperties": false }, "_usine_orchestrator_UnconfiguredWorkerNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "UnconfiguredWorkerNeed" ] }, "id": { "type": "string" }, "worker": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "attempts": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "running": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "_tag", "id", "worker", "attempts", "running" ], "additionalProperties": false }, "_usine_orchestrator_ConfigFileNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ConfigFileNeed" ] }, "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "loop", "agent" ] }, "error": { "$ref": "#/components/schemas/_usine_config_ConfigFileErrorEncoded" } }, "required": [ "_tag", "id", "kind", "error" ], "additionalProperties": false }, "_usine_orchestrator_ScheduleFailureNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ScheduleFailureNeed" ] }, "id": { "type": "string" }, "failure": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleAgentFailureEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleCronFailureEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleTickFailureEncoded" } ] } }, "required": [ "_tag", "id", "failure" ], "additionalProperties": false }, "_usine_orchestrator_ScheduleTickFailureEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ScheduleTickFailure" ] }, "loop": { "type": "string", "minLength": 1 }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "scheduledAt": { "type": "string" }, "errorTag": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "_tag", "loop", "repository", "scheduledAt", "errorTag", "message" ], "additionalProperties": false }, "_usine_orchestrator_ScheduleCronFailureEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ScheduleCronFailure" ] }, "loop": { "type": "string", "minLength": 1 }, "cron": { "type": "string" }, "tz": { "type": "string" }, "message": { "type": "string" } }, "required": [ "_tag", "loop", "cron", "tz", "message" ], "additionalProperties": false }, "_usine_orchestrator_ScheduleAgentFailureEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ScheduleAgentFailure" ] }, "loop": { "type": "string", "minLength": 1 }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "message": { "type": "string" } }, "required": [ "_tag", "loop", "agent", "message" ], "additionalProperties": false }, "_usine_orchestrator_PreflightFindingNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PreflightFindingNeed" ] }, "id": { "type": "string" }, "finding": { "$ref": "#/components/schemas/_usine_orchestrator_LabelPreflightFindingEncoded" } }, "required": [ "_tag", "id", "finding" ], "additionalProperties": false }, "_usine_orchestrator_PollFailureNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "PollFailureNeed" ] }, "id": { "type": "string" }, "failure": { "$ref": "#/components/schemas/_usine_orchestrator_RepositoryPollFailureEncoded" } }, "required": [ "_tag", "id", "failure" ], "additionalProperties": false }, "_usine_orchestrator_RepositoryPollFailureEncoded": { "type": "object", "properties": { "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "errorTag": { "type": "string", "minLength": 1 }, "message": { "type": "string" } }, "required": [ "repository", "errorTag", "message" ], "additionalProperties": false }, "_usine_orchestrator_RunFailureNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "RunFailureNeed" ] }, "id": { "type": "string" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "runId": { "type": "string", "minLength": 1 }, "loop": { "type": "string", "minLength": 1 }, "failure": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_GitHubPushFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_InfraFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ProviderCapacityFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_DefectFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_AgentFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BlockedFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_QuestionFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunawayFailureViewEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ChildSessionBudgetFailureViewEncoded" } ] }, "fixRun": { "anyOf": [ { "$ref": "#/components/schemas/_usine_engine_CiFixRunEncoded" }, { "type": "null" } ] }, "unfinishedCiAttemptId": { "type": "string", "minLength": 1 } }, "required": [ "_tag", "id", "repository", "runId", "loop", "failure", "fixRun" ], "additionalProperties": false }, "_usine_engine_CiFixRunEncoded": { "type": "object", "properties": { "runId": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "Pending", "Waiting", "Queued", "Running", "AwaitingCi", "Succeeded", "HandedOff", "Failed" ] } }, "required": [ "runId", "state" ], "additionalProperties": false }, "_usine_orchestrator_BoardProjectionNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "BoardProjectionNeed" ] }, "id": { "type": "string" }, "failure": { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionErrorEncoded" } }, "required": [ "_tag", "id", "failure" ], "additionalProperties": false }, "_usine_orchestrator_ApprovalNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "ApprovalNeed" ] }, "id": { "type": "string" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "runId": { "type": "string", "minLength": 1 }, "approvalReason": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "loop": { "type": "string", "minLength": 1 }, "item": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_BoardItemLinkEncoded" }, { "type": "null" } ] } }, "required": [ "_tag", "id", "repository", "runId", "loop", "item" ], "additionalProperties": false }, "CycleBudgetNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "CycleBudgetNeed" ] }, "id": { "type": "string" }, "ask": { "$ref": "#/components/schemas/CycleBudgetAskEncoded" }, "itemLabel": { "type": "string" }, "itemUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "_tag", "id", "ask", "itemLabel", "itemUrl" ], "additionalProperties": false }, "_usine_orchestrator_WebhookSilenceNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "WebhookSilenceNeed" ] }, "id": { "type": "string" }, "startedAt": { "type": "string" }, "publicUrl": { "type": "string" } }, "required": [ "_tag", "id", "startedAt", "publicUrl" ], "additionalProperties": false }, "_usine_orchestrator_UpgradeDrainNeedEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "UpgradeDrainNeed" ] }, "id": { "type": "string" }, "wait": { "$ref": "#/components/schemas/_usine_engine_UpgradeWaitEncoded" }, "deferredRuns": { "type": "integer", "maximum": 9007199254740991, "exclusiveMinimum": 0 } }, "required": [ "_tag", "id", "wait", "deferredRuns" ], "additionalProperties": false }, "_usine_orchestrator_LoopViewEncoded": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "trigger": { "type": "string" }, "agent": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "paused": { "type": "boolean" } }, "required": [ "name", "trigger", "agent", "paused" ], "additionalProperties": false }, "_usine_orchestrator_ReadyOverviewEncoded": { "type": "object", "properties": { "_tag": { "type": "string", "enum": [ "Ready" ] }, "identities": { "type": "array", "items": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" }, "repository": { "type": "string", "pattern": "^[A-Za-z0-9_.-]+\\/[A-Za-z0-9_.-]+$" }, "items": { "type": "array", "items": { "type": "object", "properties": { "itemKey": { "type": "string", "minLength": 1 }, "kind": { "type": "string", "enum": [ "issue", "pr" ] }, "number": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 }, "title": { "type": "string" }, "url": { "type": "string", "minLength": 1 }, "state": { "type": "string", "enum": [ "issue-open", "issue-closed", "pr-open", "pr-closed", "pr-merged" ] }, "labels": { "type": "array", "items": { "type": "string", "pattern": "^\\S(?:.*\\S)?$", "maxLength": 50 } }, "conflicting": { "type": "boolean" } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting" ], "additionalProperties": false }, "minItems": 1 } }, "required": [ "itemKey", "kind", "number", "title", "url", "state", "labels", "conflicting", "repository", "items" ], "additionalProperties": false } }, "projects": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_ProjectViewEncoded" } }, "loops": { "type": "array", "items": { "$ref": "#/components/schemas/_usine_orchestrator_LoopViewEncoded" } }, "needsYou": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeDrainNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WebhookSilenceNeedEncoded" }, { "$ref": "#/components/schemas/CycleBudgetNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PollFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PreflightFindingNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ConfigFileNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfiguredWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnresponsiveWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPreflightNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerQuotaNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPausedNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PoolLimitNeedEncoded" } ] } }, "dismissedNeeds": { "type": "array", "items": { "anyOf": [ { "$ref": "#/components/schemas/_usine_orchestrator_UpgradeDrainNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WebhookSilenceNeedEncoded" }, { "$ref": "#/components/schemas/CycleBudgetNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ApprovalNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_BoardProjectionNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_RunFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PollFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PreflightFindingNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ScheduleFailureNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_ConfigFileNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfiguredWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnconfirmedStopNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_UnresponsiveWorkerNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPreflightNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerQuotaNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_WorkerPausedNeedEncoded" }, { "$ref": "#/components/schemas/_usine_orchestrator_PoolLimitNeedEncoded" } ] } } }, "required": [ "_tag", "projects", "loops", "needsYou", "dismissedNeeds" ], "additionalProperties": false }, "_usine_orchestrator_UpgradeRequestEncoded": { "type": "object", "properties": { "timing": { "type": "string", "enum": [ "idle", "now" ] }, "version": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" } }, "required": [ "timing" ], "additionalProperties": false }, "_usine_orchestrator_UpgradeViewEncoded": { "type": "object", "properties": { "running": { "type": "string" }, "channel": { "type": "string", "enum": [ "latest", "next" ] }, "mode": { "type": "string", "enum": [ "off", "propose", "automatic" ] }, "supported": { "type": "boolean" }, "available": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, { "type": "null" } ] }, "phase": { "type": "string", "enum": [ "idle", "waiting", "installing", "failed" ] }, "target": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, { "type": "null" } ] }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "outcome": { "anyOf": [ { "$ref": "#/components/schemas/_usine_core_UpgradeInstallingEncoded" }, { "$ref": "#/components/schemas/_usine_core_UpgradeGoodEncoded" }, { "$ref": "#/components/schemas/_usine_core_UpgradeRolledBackEncoded" }, { "$ref": "#/components/schemas/_usine_core_UpgradeFailedEncoded" }, { "type": "null" } ] } }, "required": [ "running", "channel", "mode", "supported", "available", "phase", "message", "outcome" ], "additionalProperties": false }, "_usine_core_UpgradeFailedEncoded": { "type": "object", "properties": { "previous": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "status": { "type": "string", "enum": [ "failed" ] }, "reason": { "type": "string", "minLength": 1 } }, "required": [ "previous", "target", "status", "reason" ], "additionalProperties": false }, "_usine_core_UpgradeRolledBackEncoded": { "type": "object", "properties": { "previous": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "status": { "type": "string", "enum": [ "rolled-back" ] }, "reason": { "type": "string", "minLength": 1 }, "failureStage": { "type": "string", "enum": [ "install", "health-check", "unknown" ] } }, "required": [ "previous", "target", "status", "reason" ], "additionalProperties": false }, "_usine_core_UpgradeGoodEncoded": { "type": "object", "properties": { "previous": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "status": { "type": "string", "enum": [ "good" ] } }, "required": [ "previous", "target", "status" ], "additionalProperties": false }, "_usine_core_UpgradeInstallingEncoded": { "type": "object", "properties": { "previous": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "target": { "type": "string", "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$" }, "status": { "type": "string", "enum": [ "installing" ] } }, "required": [ "previous", "target", "status" ], "additionalProperties": false } }, "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "Instance-issued token or local admin token." }, "session": { "type": "apiKey", "in": "cookie", "name": "usine_session", "description": "Browser session. Writes also require X-Usine-CSRF." } } }, "security": [], "tags": [ { "name": "Operator", "description": "Instance reads, configuration revisions, and run actions." }, { "name": "Sign-in and members", "description": "GitHub sign-in, browser sessions, instance tokens, and membership." }, { "name": "GitHub App setup" }, { "name": "providers" }, { "name": "documentation" } ] }