openapi.json
Rama master · réplica de lectura del repositorio original.
{
"components": {
"schemas": {
"AuditEventRead": {
"additionalProperties": false,
"properties": {
"actor_user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Actor User Id"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"entity_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Entity Id"
},
"entity_type": {
"title": "Entity Type",
"type": "string"
},
"event_type": {
"title": "Event Type",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
},
"project_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Project Id"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Request Id"
}
},
"required": [
"id",
"actor_user_id",
"event_type",
"entity_type",
"entity_id",
"project_id",
"request_id",
"metadata",
"created_at"
],
"title": "AuditEventRead",
"type": "object"
},
"AuditPage": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/AuditEventRead"
},
"title": "Items",
"type": "array"
},
"page": {
"title": "Page",
"type": "integer"
},
"page_size": {
"title": "Page Size",
"type": "integer"
},
"total": {
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "AuditPage",
"type": "object"
},
"AuthProfile": {
"additionalProperties": false,
"properties": {
"credential_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Credential Ref"
},
"id": {
"title": "Id",
"type": "string"
},
"location": {
"anyOf": [
{
"enum": [
"header",
"query"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Location"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"prefix": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Prefix"
},
"scopes": {
"items": {
"type": "string"
},
"title": "Scopes",
"type": "array"
},
"token_auth_method": {
"default": "client_secret_basic",
"enum": [
"client_secret_basic",
"client_secret_post"
],
"title": "Token Auth Method",
"type": "string"
},
"token_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Token Url"
},
"type": {
"enum": [
"none",
"bearer",
"api_key",
"basic",
"oauth2_client_credentials",
"static_header"
],
"title": "Type",
"type": "string"
}
},
"required": [
"id",
"type"
],
"title": "AuthProfile",
"type": "object"
},
"AuthResponse": {
"additionalProperties": false,
"properties": {
"access_expires_at": {
"format": "date-time",
"title": "Access Expires At",
"type": "string"
},
"user": {
"$ref": "#/components/schemas/UserRead"
}
},
"required": [
"user",
"access_expires_at"
],
"title": "AuthResponse",
"type": "object"
},
"Body_create_upload_source_with_first_version_api_v1_projects__project_id__sources_upload_post": {
"properties": {
"file": {
"contentMediaType": "application/octet-stream",
"title": "File",
"type": "string"
},
"is_primary": {
"default": false,
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"name": {
"maxLength": 200,
"minLength": 1,
"title": "Name",
"type": "string"
},
"source_id": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
},
"required": [
"source_id",
"kind",
"name",
"file"
],
"title": "Body_create_upload_source_with_first_version_api_v1_projects__project_id__sources_upload_post",
"type": "object"
},
"Body_upload_source_version_api_v1_projects__project_id__sources__source_id__versions_post": {
"properties": {
"file": {
"contentMediaType": "application/octet-stream",
"title": "File",
"type": "string"
}
},
"required": [
"file"
],
"title": "Body_upload_source_version_api_v1_projects__project_id__sources__source_id__versions_post",
"type": "object"
},
"BuildAIRunRead": {
"additionalProperties": false,
"properties": {
"build_id": {
"format": "uuid",
"title": "Build Id",
"type": "string"
},
"cost": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Cost"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Code"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"input_context_sha256": {
"title": "Input Context Sha256",
"type": "string"
},
"latency_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Latency Ms"
},
"model": {
"title": "Model",
"type": "string"
},
"operation_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Operation Key"
},
"prompt_template_id": {
"title": "Prompt Template Id",
"type": "string"
},
"prompt_template_version": {
"title": "Prompt Template Version",
"type": "string"
},
"provider": {
"title": "Provider",
"type": "string"
},
"response_schema_id": {
"title": "Response Schema Id",
"type": "string"
},
"response_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Response Sha256"
},
"retrieved_chunk_ids": {
"items": {
"type": "string"
},
"title": "Retrieved Chunk Ids",
"type": "array"
},
"run_key": {
"title": "Run Key",
"type": "string"
},
"stage": {
"title": "Stage",
"type": "string"
},
"status": {
"title": "Status",
"type": "string"
},
"usage": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"title": "Usage"
}
},
"required": [
"id",
"build_id",
"run_key",
"stage",
"operation_key",
"provider",
"model",
"prompt_template_id",
"prompt_template_version",
"input_context_sha256",
"retrieved_chunk_ids",
"response_schema_id",
"response_sha256",
"usage",
"cost",
"latency_ms",
"status",
"error_code",
"created_at"
],
"title": "BuildAIRunRead",
"type": "object"
},
"BuildAdmissionOverviewRead": {
"additionalProperties": false,
"properties": {
"configured_concurrency": {
"title": "Configured Concurrency",
"type": "integer"
},
"effective_concurrency": {
"title": "Effective Concurrency",
"type": "integer"
},
"entries": {
"items": {
"$ref": "#/components/schemas/QueuedBuildAdmissionRead"
},
"title": "Entries",
"type": "array"
},
"waiting_count": {
"title": "Waiting Count",
"type": "integer"
}
},
"required": [
"configured_concurrency",
"effective_concurrency",
"waiting_count",
"entries"
],
"title": "BuildAdmissionOverviewRead",
"type": "object"
},
"BuildAdmissionState": {
"enum": [
"waiting",
"admitted",
"running"
],
"title": "BuildAdmissionState",
"type": "string"
},
"BuildCreate": {
"additionalProperties": false,
"properties": {
"trigger": {
"const": "initial",
"default": "initial",
"title": "Trigger",
"type": "string"
}
},
"title": "BuildCreate",
"type": "object"
},
"BuildDiffRead": {
"additionalProperties": false,
"properties": {
"added_operations": {
"items": {
"type": "string"
},
"title": "Added Operations",
"type": "array"
},
"changed_documents": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Changed Documents",
"type": "array"
},
"changed_operations": {
"items": {
"$ref": "#/components/schemas/OperationChangeRead"
},
"title": "Changed Operations",
"type": "array"
},
"changed_schemas": {
"items": {
"type": "string"
},
"title": "Changed Schemas",
"type": "array"
},
"changed_security": {
"items": {
"type": "string"
},
"title": "Changed Security",
"type": "array"
},
"removed_operations": {
"items": {
"type": "string"
},
"title": "Removed Operations",
"type": "array"
},
"unchanged_operations": {
"items": {
"type": "string"
},
"title": "Unchanged Operations",
"type": "array"
}
},
"required": [
"added_operations",
"removed_operations",
"changed_operations",
"unchanged_operations",
"changed_schemas",
"changed_security",
"changed_documents"
],
"title": "BuildDiffRead",
"type": "object"
},
"BuildMetadata": {
"additionalProperties": false,
"properties": {
"analysis_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Model"
},
"build_id": {
"title": "Build Id",
"type": "string"
},
"canonical_sha256": {
"pattern": "^[a-f0-9]{64}$",
"title": "Canonical Sha256",
"type": "string"
},
"compiler_version": {
"title": "Compiler Version",
"type": "string"
},
"created_at": {
"title": "Created At",
"type": "string"
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model"
},
"prompt_bundle_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Prompt Bundle Version"
},
"source_digest": {
"pattern": "^[a-f0-9]{64}$",
"title": "Source Digest",
"type": "string"
},
"source_version_ids": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Source Version Ids",
"type": "array"
},
"validation_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Validation Model"
}
},
"required": [
"build_id",
"source_version_ids",
"source_digest",
"canonical_sha256",
"created_at",
"compiler_version"
],
"title": "BuildMetadata",
"type": "object"
},
"BuildMetricsRead": {
"additionalProperties": false,
"properties": {
"active": {
"minimum": 0.0,
"title": "Active",
"type": "integer"
},
"failed": {
"minimum": 0.0,
"title": "Failed",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"total",
"active",
"failed"
],
"title": "BuildMetricsRead",
"type": "object"
},
"BuildPageRead": {
"additionalProperties": false,
"properties": {
"has_active": {
"title": "Has Active",
"type": "boolean"
},
"items": {
"items": {
"$ref": "#/components/schemas/BuildRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size",
"has_active"
],
"title": "BuildPageRead",
"type": "object"
},
"BuildRead": {
"additionalProperties": false,
"properties": {
"admission_acquired_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admission Acquired At"
},
"admission_attempt_count": {
"title": "Admission Attempt Count",
"type": "integer"
},
"admission_enqueued_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admission Enqueued At"
},
"admission_heartbeat_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admission Heartbeat At"
},
"admission_lease_expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admission Lease Expires At"
},
"admission_released_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admission Released At"
},
"analysis_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Model"
},
"artifact_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Artifact Sha256"
},
"cancellation_acknowledged_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Cancellation Acknowledged At"
},
"cancellation_requested_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Cancellation Requested At"
},
"cancellation_requested_by": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Cancellation Requested By"
},
"canonical_snapshot_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Canonical Snapshot Id"
},
"compiler_version": {
"title": "Compiler Version",
"type": "string"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Completed At"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"embedding_dimensions": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Embedding Dimensions"
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model"
},
"error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Code"
},
"error_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Summary"
},
"executable_configuration_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Executable Configuration Sha256"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"manifest_schema_version": {
"title": "Manifest Schema Version",
"type": "string"
},
"manifest_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Manifest Sha256"
},
"pipeline_stage": {
"anyOf": [
{
"$ref": "#/components/schemas/BuildStatus"
},
{
"type": "null"
}
]
},
"previous_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Previous Build Id"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"prompt_bundle_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Prompt Bundle Version"
},
"runtime_compatibility": {
"title": "Runtime Compatibility",
"type": "string"
},
"sequence": {
"title": "Sequence",
"type": "integer"
},
"started_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Started At"
},
"status": {
"$ref": "#/components/schemas/BuildStatus"
},
"trigger": {
"$ref": "#/components/schemas/BuildTrigger"
},
"validation_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Validation Model"
}
},
"required": [
"id",
"project_id",
"sequence",
"status",
"pipeline_stage",
"trigger",
"executable_configuration_sha256",
"canonical_snapshot_id",
"previous_build_id",
"compiler_version",
"manifest_schema_version",
"runtime_compatibility",
"analysis_model",
"validation_model",
"embedding_model",
"embedding_dimensions",
"prompt_bundle_version",
"manifest_sha256",
"artifact_sha256",
"error_code",
"error_summary",
"created_at",
"started_at",
"completed_at",
"cancellation_requested_at",
"cancellation_requested_by",
"cancellation_acknowledged_at",
"admission_acquired_at",
"admission_enqueued_at",
"admission_heartbeat_at",
"admission_lease_expires_at",
"admission_released_at",
"admission_attempt_count"
],
"title": "BuildRead",
"type": "object"
},
"BuildStatus": {
"enum": [
"QUEUED",
"INGESTING",
"PARSING",
"INDEXING",
"ANALYZING",
"COMPILING",
"VALIDATING",
"PACKAGING",
"READY",
"FAILED",
"CANCELLED"
],
"title": "BuildStatus",
"type": "string"
},
"BuildTrigger": {
"enum": [
"initial",
"source_change",
"manual_review",
"manual_rebuild"
],
"title": "BuildTrigger",
"type": "string"
},
"CleanupJobKind": {
"enum": [
"project_delete",
"source_delete",
"retention",
"orphan_guard"
],
"title": "CleanupJobKind",
"type": "string"
},
"CleanupJobRead": {
"additionalProperties": false,
"properties": {
"completed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Completed At"
},
"completed_targets": {
"title": "Completed Targets",
"type": "integer"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"failed_targets": {
"title": "Failed Targets",
"type": "integer"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"kind": {
"$ref": "#/components/schemas/CleanupJobKind"
},
"last_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Error Code"
},
"last_error_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Error Summary"
},
"project_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Project Id"
},
"request_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Request Id"
},
"requested_by": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Requested By"
},
"skipped_targets": {
"title": "Skipped Targets",
"type": "integer"
},
"status": {
"$ref": "#/components/schemas/CleanupJobStatus"
},
"total_targets": {
"title": "Total Targets",
"type": "integer"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
}
},
"required": [
"id",
"kind",
"status",
"project_id",
"requested_by",
"request_id",
"total_targets",
"completed_targets",
"skipped_targets",
"failed_targets",
"last_error_code",
"last_error_summary",
"created_at",
"updated_at",
"completed_at"
],
"title": "CleanupJobRead",
"type": "object"
},
"CleanupJobStatus": {
"enum": [
"pending",
"running",
"retrying",
"completed",
"failed"
],
"title": "CleanupJobStatus",
"type": "string"
},
"CredentialCreate": {
"additionalProperties": false,
"properties": {
"metadata": {
"additionalProperties": {
"type": "string"
},
"title": "Metadata",
"type": "object"
},
"name": {
"maxLength": 160,
"minLength": 1,
"title": "Name",
"type": "string"
},
"scheme_type": {
"$ref": "#/components/schemas/CredentialScheme"
},
"secret": {
"$ref": "#/components/schemas/CredentialSecretInput"
}
},
"required": [
"name",
"scheme_type",
"secret"
],
"title": "CredentialCreate",
"type": "object"
},
"CredentialRead": {
"additionalProperties": false,
"properties": {
"configured": {
"default": true,
"title": "Configured",
"type": "boolean"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
},
"name": {
"title": "Name",
"type": "string"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"revoked_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Revoked At"
},
"rotated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Rotated At"
},
"runtime_command_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Command Id"
},
"runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"runtime_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Error Code"
},
"scheme_type": {
"$ref": "#/components/schemas/CredentialScheme"
}
},
"required": [
"id",
"project_id",
"name",
"scheme_type",
"metadata",
"created_by",
"created_at",
"rotated_at",
"revoked_at",
"runtime_effect_state",
"runtime_command_id",
"runtime_error_code"
],
"title": "CredentialRead",
"type": "object"
},
"CredentialRotate": {
"additionalProperties": false,
"properties": {
"metadata": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Metadata"
},
"secret": {
"$ref": "#/components/schemas/CredentialSecretInput"
}
},
"required": [
"secret"
],
"title": "CredentialRotate",
"type": "object"
},
"CredentialScheme": {
"enum": [
"bearer",
"api_key_header",
"api_key_query",
"basic",
"oauth2_client_credentials",
"static_headers"
],
"title": "CredentialScheme",
"type": "string"
},
"CredentialSecretInput": {
"additionalProperties": false,
"properties": {
"client_id": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Client Id"
},
"client_secret": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Client Secret"
},
"headers": {
"anyOf": [
{
"additionalProperties": {
"format": "password",
"type": "string",
"writeOnly": true
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Headers"
},
"password": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Password"
},
"token": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Token"
},
"username": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Username"
},
"value": {
"anyOf": [
{
"format": "password",
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Value"
}
},
"title": "CredentialSecretInput",
"type": "object"
},
"DeploymentActivationPhase": {
"enum": [
"verified",
"retiring_previous",
"running",
"legacy_running",
"failed"
],
"title": "DeploymentActivationPhase",
"type": "string"
},
"DeploymentCreate": {
"additionalProperties": false,
"properties": {
"build_id": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
},
"required": [
"build_id"
],
"title": "DeploymentCreate",
"type": "object"
},
"DeploymentIntent": {
"enum": [
"normal",
"security_refresh",
"rollback"
],
"title": "DeploymentIntent",
"type": "string"
},
"DeploymentPageRead": {
"additionalProperties": false,
"properties": {
"has_active": {
"title": "Has Active",
"type": "boolean"
},
"items": {
"items": {
"$ref": "#/components/schemas/DeploymentRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size",
"has_active"
],
"title": "DeploymentPageRead",
"type": "object"
},
"DeploymentRead": {
"additionalProperties": false,
"properties": {
"activated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Activated At"
},
"activation_phase": {
"anyOf": [
{
"$ref": "#/components/schemas/DeploymentActivationPhase"
},
{
"type": "null"
}
]
},
"activation_proof_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Activation Proof Sha256"
},
"activation_verified_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Activation Verified At"
},
"auth_overlay_sha256": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Auth Overlay Sha256"
},
"build_id": {
"format": "uuid",
"title": "Build Id",
"type": "string"
},
"container_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Container Id"
},
"container_name": {
"title": "Container Name",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"endpoint_url": {
"title": "Endpoint Url",
"type": "string"
},
"error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Code"
},
"error_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Summary"
},
"failed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Failed At"
},
"health_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Health Status"
},
"hostname": {
"title": "Hostname",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"image_digest": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Image Digest"
},
"image_ref": {
"title": "Image Ref",
"type": "string"
},
"intent": {
"$ref": "#/components/schemas/DeploymentIntent"
},
"manifest_sha256": {
"title": "Manifest Sha256",
"type": "string"
},
"network_name": {
"title": "Network Name",
"type": "string"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"rollback_eligible": {
"title": "Rollback Eligible",
"type": "boolean"
},
"runtime_version": {
"title": "Runtime Version",
"type": "string"
},
"started_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Started At"
},
"status": {
"$ref": "#/components/schemas/DeploymentStatus"
},
"stopped_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Stopped At"
}
},
"required": [
"id",
"project_id",
"build_id",
"intent",
"status",
"hostname",
"endpoint_url",
"container_name",
"container_id",
"image_ref",
"image_digest",
"runtime_version",
"network_name",
"manifest_sha256",
"auth_overlay_sha256",
"health_status",
"created_at",
"started_at",
"activated_at",
"activation_phase",
"activation_verified_at",
"activation_proof_sha256",
"stopped_at",
"failed_at",
"error_code",
"error_summary",
"rollback_eligible"
],
"title": "DeploymentRead",
"type": "object"
},
"DeploymentRollback": {
"additionalProperties": false,
"properties": {
"target_deployment_id": {
"format": "uuid",
"title": "Target Deployment Id",
"type": "string"
}
},
"required": [
"target_deployment_id"
],
"title": "DeploymentRollback",
"type": "object"
},
"DeploymentStatus": {
"enum": [
"pending",
"deploying",
"healthcheck",
"running",
"unhealthy",
"stopping",
"stopped",
"failed"
],
"title": "DeploymentStatus",
"type": "string"
},
"FindingSeverity": {
"enum": [
"error",
"warning",
"info"
],
"title": "FindingSeverity",
"type": "string"
},
"HTTPValidationError": {
"properties": {
"detail": {
"items": {
"$ref": "#/components/schemas/ValidationError"
},
"title": "Detail",
"type": "array"
}
},
"title": "HTTPValidationError",
"type": "object"
},
"HealthRead": {
"additionalProperties": false,
"properties": {
"service": {
"const": "mcplica-api",
"title": "Service",
"type": "string"
},
"status": {
"const": "ok",
"title": "Status",
"type": "string"
},
"version": {
"title": "Version",
"type": "string"
}
},
"required": [
"status",
"service",
"version"
],
"title": "HealthRead",
"type": "object"
},
"HttpMethod": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD",
"OPTIONS",
"TRACE"
],
"title": "HttpMethod",
"type": "string"
},
"IndexGenerationStatus": {
"enum": [
"building",
"ready",
"failed"
],
"title": "IndexGenerationStatus",
"type": "string"
},
"JourneySourceRecord": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_primary": {
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"name": {
"title": "Name",
"type": "string"
},
"version_id": {
"format": "uuid",
"title": "Version Id",
"type": "string"
}
},
"required": [
"id",
"version_id",
"kind",
"name",
"is_primary"
],
"title": "JourneySourceRecord",
"type": "object"
},
"JourneyStepRecord": {
"additionalProperties": false,
"properties": {
"authorized": {
"title": "Authorized",
"type": "boolean"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Message"
},
"number": {
"maximum": 10.0,
"minimum": 1.0,
"title": "Number",
"type": "integer"
},
"reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason Code"
},
"remediation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remediation"
},
"state": {
"$ref": "#/components/schemas/JourneyStepState"
}
},
"required": [
"number",
"state",
"authorized"
],
"title": "JourneyStepRecord",
"type": "object"
},
"JourneyStepState": {
"enum": [
"complete",
"current",
"stale",
"locked"
],
"title": "JourneyStepState",
"type": "string"
},
"JsonObject": {
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"type": "object"
},
"JsonScalar": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"JsonValue": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonScalar"
},
{
"items": {
"$ref": "#/components/schemas/JsonValue"
},
"type": "array"
},
{
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"type": "object"
}
]
},
"LoginRequest": {
"additionalProperties": false,
"properties": {
"email": {
"format": "email",
"title": "Email",
"type": "string"
},
"password": {
"format": "password",
"maxLength": 1024,
"minLength": 1,
"title": "Password",
"type": "string",
"writeOnly": true
}
},
"required": [
"email",
"password"
],
"title": "LoginRequest",
"type": "object"
},
"MCPAccessRead": {
"additionalProperties": false,
"properties": {
"auth_config": {
"anyOf": [
{
"$ref": "#/components/schemas/MCPAuthConfigRead"
},
{
"type": "null"
}
]
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"tokens": {
"items": {
"$ref": "#/components/schemas/MCPAccessTokenRead"
},
"title": "Tokens",
"type": "array"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"auth_config",
"tokens",
"total",
"page",
"page_size"
],
"title": "MCPAccessRead",
"type": "object"
},
"MCPAccessStatusRead": {
"additionalProperties": false,
"properties": {
"configured": {
"title": "Configured",
"type": "boolean"
},
"mode": {
"anyOf": [
{
"$ref": "#/components/schemas/MCPAuthMode"
},
{
"type": "null"
}
]
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"remediation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Remediation"
},
"runtime_command_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Command Id"
},
"runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"runtime_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Error Code"
}
},
"required": [
"project_id",
"mode",
"configured",
"remediation",
"runtime_effect_state",
"runtime_command_id",
"runtime_error_code"
],
"title": "MCPAccessStatusRead",
"type": "object"
},
"MCPAccessTokenCreate": {
"additionalProperties": false,
"properties": {
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Expires At"
},
"name": {
"maxLength": 160,
"minLength": 1,
"title": "Name",
"type": "string"
}
},
"required": [
"name"
],
"title": "MCPAccessTokenCreate",
"type": "object"
},
"MCPAccessTokenIssued": {
"additionalProperties": false,
"properties": {
"plaintext": {
"title": "Plaintext",
"type": "string"
},
"token": {
"$ref": "#/components/schemas/MCPAccessTokenRead"
}
},
"required": [
"token",
"plaintext"
],
"title": "MCPAccessTokenIssued",
"type": "object"
},
"MCPAccessTokenRead": {
"properties": {
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Expires At"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"last_used_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Used At"
},
"name": {
"title": "Name",
"type": "string"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"revoked_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Revoked At"
},
"runtime_command_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Command Id"
},
"runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"runtime_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Error Code"
},
"token_prefix": {
"title": "Token Prefix",
"type": "string"
}
},
"required": [
"id",
"project_id",
"name",
"token_prefix",
"created_by",
"created_at",
"expires_at",
"last_used_at",
"revoked_at",
"runtime_effect_state",
"runtime_command_id",
"runtime_error_code"
],
"title": "MCPAccessTokenRead",
"type": "object"
},
"MCPAccessTokenRotate": {
"additionalProperties": false,
"properties": {
"overlap_seconds": {
"default": 300,
"maximum": 900.0,
"minimum": 0.0,
"title": "Overlap Seconds",
"type": "integer"
}
},
"title": "MCPAccessTokenRotate",
"type": "object"
},
"MCPAuthConfigRead": {
"properties": {
"audiences": {
"items": {
"type": "string"
},
"title": "Audiences",
"type": "array"
},
"issuer_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Issuer Url"
},
"metadata": {
"additionalProperties": true,
"title": "Metadata",
"type": "object"
},
"mode": {
"$ref": "#/components/schemas/MCPAuthMode"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"required_scopes": {
"items": {
"type": "string"
},
"title": "Required Scopes",
"type": "array"
},
"runtime_command_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Command Id"
},
"runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"runtime_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Error Code"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
},
"updated_by": {
"format": "uuid",
"title": "Updated By",
"type": "string"
}
},
"required": [
"project_id",
"mode",
"issuer_url",
"audiences",
"required_scopes",
"metadata",
"updated_by",
"updated_at",
"runtime_effect_state",
"runtime_command_id",
"runtime_error_code"
],
"title": "MCPAuthConfigRead",
"type": "object"
},
"MCPAuthConfigUpdate": {
"additionalProperties": false,
"properties": {
"allowed_algorithms": {
"items": {
"type": "string"
},
"maxItems": 20,
"title": "Allowed Algorithms",
"type": "array"
},
"audiences": {
"items": {
"type": "string"
},
"maxItems": 50,
"title": "Audiences",
"type": "array"
},
"issuer_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Issuer Url"
},
"jwks_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Jwks Url"
},
"mode": {
"$ref": "#/components/schemas/MCPAuthMode"
},
"required_scopes": {
"items": {
"type": "string"
},
"maxItems": 100,
"title": "Required Scopes",
"type": "array"
}
},
"required": [
"mode"
],
"title": "MCPAuthConfigUpdate",
"type": "object"
},
"MCPAuthMode": {
"enum": [
"static_bearer",
"external_oauth_oidc",
"disabled_dev"
],
"title": "MCPAuthMode",
"type": "string"
},
"MCPManifest": {
"additionalProperties": false,
"properties": {
"auth_profiles": {
"items": {
"$ref": "#/components/schemas/AuthProfile"
},
"title": "Auth Profiles",
"type": "array"
},
"build": {
"$ref": "#/components/schemas/BuildMetadata"
},
"manifest_id": {
"pattern": "^[a-f0-9]{64}$",
"title": "Manifest Id",
"type": "string"
},
"project": {
"$ref": "#/components/schemas/ManifestProject"
},
"resources": {
"items": {
"$ref": "#/components/schemas/MCPResource"
},
"title": "Resources",
"type": "array"
},
"runtime_compatibility": {
"default": ">=1.0.0-rc.2,<2.0",
"title": "Runtime Compatibility",
"type": "string"
},
"schema_version": {
"const": "mcp-manifest/v1",
"default": "mcp-manifest/v1",
"title": "Schema Version",
"type": "string"
},
"security": {
"$ref": "#/components/schemas/RuntimeSecurity"
},
"servers": {
"items": {
"$ref": "#/components/schemas/ServerDefinition"
},
"minItems": 1,
"title": "Servers",
"type": "array"
},
"tools": {
"items": {
"$ref": "#/components/schemas/MCPTool"
},
"title": "Tools",
"type": "array"
}
},
"required": [
"manifest_id",
"project",
"servers",
"tools",
"security",
"build"
],
"title": "MCPManifest",
"type": "object"
},
"MCPResource": {
"additionalProperties": false,
"properties": {
"content": {
"title": "Content",
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"mime_type": {
"default": "text/markdown",
"title": "Mime Type",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"provenance": {
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"title": "Provenance",
"type": "object"
},
"uri": {
"title": "Uri",
"type": "string"
}
},
"required": [
"uri",
"name",
"content"
],
"title": "MCPResource",
"type": "object"
},
"MCPTool": {
"additionalProperties": false,
"properties": {
"description": {
"title": "Description",
"type": "string"
},
"enabled": {
"default": true,
"title": "Enabled",
"type": "boolean"
},
"input_schema": {
"$ref": "#/components/schemas/JsonObject"
},
"max_request_bytes": {
"default": 10000000,
"maximum": 100000000.0,
"minimum": 1024.0,
"title": "Max Request Bytes",
"type": "integer"
},
"max_response_bytes": {
"default": 2000000,
"maximum": 50000000.0,
"minimum": 1024.0,
"title": "Max Response Bytes",
"type": "integer"
},
"name": {
"pattern": "^[a-z_][a-z0-9_]{0,127}$",
"title": "Name",
"type": "string"
},
"operation_key": {
"title": "Operation Key",
"type": "string"
},
"output_schema": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"provenance": {
"additionalProperties": {
"$ref": "#/components/schemas/JsonValue"
},
"title": "Provenance",
"type": "object"
},
"request_mapping": {
"$ref": "#/components/schemas/RequestMapping"
},
"responses": {
"items": {
"$ref": "#/components/schemas/ResponseDefinition"
},
"title": "Responses",
"type": "array"
},
"security_profile_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Security Profile Ref"
},
"timeout_ms": {
"default": 30000,
"maximum": 300000.0,
"minimum": 100.0,
"title": "Timeout Ms",
"type": "integer"
},
"title": {
"title": "Title",
"type": "string"
}
},
"required": [
"name",
"title",
"description",
"input_schema",
"operation_key",
"request_mapping"
],
"title": "MCPTool",
"type": "object"
},
"ManifestProject": {
"additionalProperties": false,
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"slug": {
"title": "Slug",
"type": "string"
}
},
"required": [
"id",
"name",
"slug"
],
"title": "ManifestProject",
"type": "object"
},
"ModelCatalogItem": {
"additionalProperties": false,
"properties": {
"context_length": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Context Length"
},
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"supports_embeddings": {
"title": "Supports Embeddings",
"type": "boolean"
},
"supports_structured_outputs": {
"title": "Supports Structured Outputs",
"type": "boolean"
}
},
"required": [
"id",
"name",
"supports_structured_outputs",
"supports_embeddings"
],
"title": "ModelCatalogItem",
"type": "object"
},
"ModelSettingsRead": {
"additionalProperties": false,
"properties": {
"analysis_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Model"
},
"embedding_dimensions": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Embedding Dimensions"
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model"
},
"include_documentation_in_analysis": {
"title": "Include Documentation In Analysis",
"type": "boolean"
},
"openrouter_configured": {
"title": "Openrouter Configured",
"type": "boolean"
},
"updated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
},
"validation_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Validation Model"
}
},
"required": [
"openrouter_configured",
"analysis_model",
"validation_model",
"embedding_model",
"embedding_dimensions",
"include_documentation_in_analysis",
"updated_at"
],
"title": "ModelSettingsRead",
"type": "object"
},
"ModelSettingsUpdate": {
"additionalProperties": false,
"properties": {
"analysis_model": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"title": "Analysis Model"
},
"embedding_model": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model"
},
"include_documentation_in_analysis": {
"default": false,
"title": "Include Documentation In Analysis",
"type": "boolean"
},
"validation_model": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"title": "Validation Model"
}
},
"title": "ModelSettingsUpdate",
"type": "object"
},
"ModelUsageRead": {
"additionalProperties": false,
"properties": {
"call_count": {
"title": "Call Count",
"type": "integer"
},
"is_attributable": {
"title": "Is Attributable",
"type": "boolean"
},
"model": {
"title": "Model",
"type": "string"
},
"total_cost": {
"title": "Total Cost",
"type": "number"
},
"total_tokens": {
"title": "Total Tokens",
"type": "integer"
}
},
"required": [
"model",
"call_count",
"total_tokens",
"total_cost",
"is_attributable"
],
"title": "ModelUsageRead",
"type": "object"
},
"MultipartFileMapping": {
"additionalProperties": false,
"properties": {
"content_field": {
"title": "Content Field",
"type": "string"
},
"content_type_field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Content Type Field"
},
"default_content_type": {
"default": "application/octet-stream",
"title": "Default Content Type",
"type": "string"
},
"default_filename": {
"default": "upload.bin",
"title": "Default Filename",
"type": "string"
},
"filename_field": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Filename Field"
},
"part_name": {
"title": "Part Name",
"type": "string"
},
"required": {
"default": false,
"title": "Required",
"type": "boolean"
}
},
"required": [
"part_name",
"content_field"
],
"title": "MultipartFileMapping",
"type": "object"
},
"OpenRouterSecretUpdate": {
"additionalProperties": false,
"properties": {
"api_key": {
"format": "password",
"maxLength": 500,
"minLength": 10,
"title": "Api Key",
"type": "string",
"writeOnly": true
}
},
"required": [
"api_key"
],
"title": "OpenRouterSecretUpdate",
"type": "object"
},
"OpenRouterTestResult": {
"additionalProperties": false,
"properties": {
"message": {
"title": "Message",
"type": "string"
},
"ok": {
"title": "Ok",
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"title": "OpenRouterTestResult",
"type": "object"
},
"OperationChangeRead": {
"additionalProperties": false,
"properties": {
"changes": {
"items": {
"type": "string"
},
"title": "Changes",
"type": "array"
},
"operation_key": {
"title": "Operation Key",
"type": "string"
}
},
"required": [
"operation_key",
"changes"
],
"title": "OperationChangeRead",
"type": "object"
},
"OperationExclusionCreate": {
"additionalProperties": false,
"properties": {
"operation_key": {
"maxLength": 160,
"minLength": 1,
"title": "Operation Key",
"type": "string"
},
"reason": {
"maxLength": 2000,
"minLength": 5,
"title": "Reason",
"type": "string"
}
},
"required": [
"operation_key",
"reason"
],
"title": "OperationExclusionCreate",
"type": "object"
},
"OperationExclusionRead": {
"additionalProperties": false,
"properties": {
"build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Build Id"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_user_requested": {
"title": "Is User Requested",
"type": "boolean"
},
"operation_key": {
"title": "Operation Key",
"type": "string"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"reason": {
"title": "Reason",
"type": "string"
},
"reason_code": {
"title": "Reason Code",
"type": "string"
}
},
"required": [
"id",
"project_id",
"build_id",
"operation_key",
"reason_code",
"reason",
"is_user_requested",
"created_by",
"created_at"
],
"title": "OperationExclusionRead",
"type": "object"
},
"OperationPageItemRead": {
"additionalProperties": false,
"properties": {
"auth_mapping": {
"items": {
"type": "string"
},
"title": "Auth Mapping",
"type": "array"
},
"build_exclusion_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Build Exclusion Id"
},
"build_exclusion_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Build Exclusion Reason"
},
"confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Confidence"
},
"current_exclusion_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Exclusion Id"
},
"current_exclusion_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Exclusion Reason"
},
"enriched_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Enriched Description"
},
"excluded_in_build": {
"title": "Excluded In Build",
"type": "boolean"
},
"input_schema": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"key": {
"title": "Key",
"type": "string"
},
"method": {
"title": "Method",
"type": "string"
},
"path_template": {
"title": "Path Template",
"type": "string"
},
"provenance": {
"items": {
"$ref": "#/components/schemas/JsonObject"
},
"title": "Provenance",
"type": "array"
},
"semantic_warnings": {
"items": {
"type": "string"
},
"title": "Semantic Warnings",
"type": "array"
},
"source_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Description"
},
"source_operation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Operation Id"
},
"source_summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Summary"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Title"
},
"tool_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tool Name"
}
},
"required": [
"key",
"source_operation_id",
"method",
"path_template",
"tool_name",
"title",
"source_summary",
"source_description",
"enriched_description",
"input_schema",
"auth_mapping",
"provenance",
"semantic_warnings",
"confidence",
"excluded_in_build",
"build_exclusion_id",
"build_exclusion_reason",
"current_exclusion_id",
"current_exclusion_reason"
],
"title": "OperationPageItemRead",
"type": "object"
},
"OperationPageRead": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/OperationPageItemRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"policy_change_count": {
"minimum": 0.0,
"title": "Policy Change Count",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size",
"policy_change_count"
],
"title": "OperationPageRead",
"type": "object"
},
"OperationSecurityRequirementRead": {
"additionalProperties": false,
"properties": {
"alternatives": {
"items": {
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object"
},
"title": "Alternatives",
"type": "array"
},
"anonymous_allowed": {
"title": "Anonymous Allowed",
"type": "boolean"
},
"operation_key": {
"title": "Operation Key",
"type": "string"
}
},
"required": [
"operation_key",
"alternatives",
"anonymous_allowed"
],
"title": "OperationSecurityRequirementRead",
"type": "object"
},
"OperationServerRoutingRead": {
"additionalProperties": false,
"properties": {
"candidate_refs": {
"items": {
"type": "string"
},
"title": "Candidate Refs",
"type": "array"
},
"configured_server_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Configured Server Ref"
},
"method": {
"title": "Method",
"type": "string"
},
"operation_key": {
"title": "Operation Key",
"type": "string"
},
"path": {
"title": "Path",
"type": "string"
},
"selected_server_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Selected Server Ref"
},
"selection_error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Selection Error"
},
"selection_required": {
"title": "Selection Required",
"type": "boolean"
}
},
"required": [
"operation_key",
"method",
"path",
"candidate_refs",
"selected_server_ref",
"configured_server_ref",
"selection_required",
"selection_error"
],
"title": "OperationServerRoutingRead",
"type": "object"
},
"Page_BuildAIRunRead_": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/BuildAIRunRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "Page[BuildAIRunRead]",
"type": "object"
},
"Page_CredentialRead_": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/CredentialRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "Page[CredentialRead]",
"type": "object"
},
"Page_ProjectRead_": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/ProjectRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "Page[ProjectRead]",
"type": "object"
},
"Page_UserRead_": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/UserRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 200.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "Page[UserRead]",
"type": "object"
},
"ParameterMapping": {
"additionalProperties": false,
"properties": {
"allow_reserved": {
"default": false,
"title": "Allow Reserved",
"type": "boolean"
},
"explode": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Explode"
},
"required": {
"default": false,
"title": "Required",
"type": "boolean"
},
"source_name": {
"title": "Source Name",
"type": "string"
},
"style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Style"
},
"target": {
"$ref": "#/components/schemas/ParameterTarget"
},
"tool_field": {
"title": "Tool Field",
"type": "string"
}
},
"required": [
"tool_field",
"source_name",
"target"
],
"title": "ParameterMapping",
"type": "object"
},
"ParameterTarget": {
"enum": [
"path",
"query",
"header"
],
"title": "ParameterTarget",
"type": "string"
},
"ProjectCreate": {
"additionalProperties": false,
"properties": {
"default_base_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Default Base Url"
},
"description": {
"anyOf": [
{
"maxLength": 10000,
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"name": {
"maxLength": 160,
"minLength": 1,
"title": "Name",
"type": "string"
},
"slug": {
"maxLength": 63,
"minLength": 3,
"title": "Slug",
"type": "string"
}
},
"required": [
"name",
"slug"
],
"title": "ProjectCreate",
"type": "object"
},
"ProjectJourneyRead": {
"additionalProperties": false,
"properties": {
"access_configured": {
"title": "Access Configured",
"type": "boolean"
},
"access_mode": {
"anyOf": [
{
"$ref": "#/components/schemas/MCPAuthMode"
},
{
"type": "null"
}
]
},
"access_remediation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Access Remediation"
},
"access_runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"active_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Build Id"
},
"active_deployment_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Deployment Id"
},
"active_deployment_status": {
"anyOf": [
{
"$ref": "#/components/schemas/DeploymentStatus"
},
{
"type": "null"
}
]
},
"bound_security_schemes": {
"items": {
"type": "string"
},
"title": "Bound Security Schemes",
"type": "array"
},
"build_stale": {
"title": "Build Stale",
"type": "boolean"
},
"build_status": {
"anyOf": [
{
"$ref": "#/components/schemas/BuildStatus"
},
{
"type": "null"
}
]
},
"can_deploy": {
"title": "Can Deploy",
"type": "boolean"
},
"can_manage_credentials": {
"title": "Can Manage Credentials",
"type": "boolean"
},
"can_manage_mcp_access": {
"title": "Can Manage Mcp Access",
"type": "boolean"
},
"credential_mapping_complete": {
"title": "Credential Mapping Complete",
"type": "boolean"
},
"credential_mapping_required": {
"title": "Credential Mapping Required",
"type": "boolean"
},
"deployability_reason_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Deployability Reason Code"
},
"deployability_remediation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Deployability Remediation"
},
"deployable": {
"title": "Deployable",
"type": "boolean"
},
"deployment_transition_in_progress": {
"title": "Deployment Transition In Progress",
"type": "boolean"
},
"preflight_ready": {
"title": "Preflight Ready",
"type": "boolean"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"requested_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Requested Build Id"
},
"resume_step": {
"maximum": 10.0,
"minimum": 1.0,
"title": "Resume Step",
"type": "integer"
},
"routing_complete": {
"title": "Routing Complete",
"type": "boolean"
},
"selected_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Selected Build Id"
},
"source_version_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Source Version Ids",
"type": "array"
},
"sources": {
"items": {
"$ref": "#/components/schemas/JourneySourceRecord"
},
"title": "Sources",
"type": "array"
},
"steps": {
"items": {
"$ref": "#/components/schemas/JourneyStepRecord"
},
"maxItems": 10,
"minItems": 10,
"title": "Steps",
"type": "array"
},
"validation_complete": {
"title": "Validation Complete",
"type": "boolean"
},
"validation_status": {
"anyOf": [
{
"$ref": "#/components/schemas/ValidationStatus"
},
{
"type": "null"
}
]
}
},
"required": [
"project_id",
"requested_build_id",
"selected_build_id",
"active_build_id",
"active_deployment_id",
"resume_step",
"steps",
"sources",
"source_version_ids",
"routing_complete",
"credential_mapping_required",
"credential_mapping_complete",
"bound_security_schemes",
"access_mode",
"access_configured",
"access_runtime_effect_state",
"access_remediation",
"build_status",
"build_stale",
"validation_status",
"validation_complete",
"active_deployment_status",
"deployment_transition_in_progress",
"preflight_ready",
"deployable",
"deployability_reason_code",
"deployability_remediation",
"can_manage_credentials",
"can_manage_mcp_access",
"can_deploy"
],
"title": "ProjectJourneyRead",
"type": "object"
},
"ProjectRead": {
"properties": {
"active_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Build Id"
},
"active_deployment_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Deployment Id"
},
"active_server_ref": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Server Ref"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"default_base_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Default Base Url"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_enabled": {
"title": "Is Enabled",
"type": "boolean"
},
"mcp_hostname": {
"title": "Mcp Hostname",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"runtime_command_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Command Id"
},
"runtime_effect_state": {
"$ref": "#/components/schemas/RuntimeEffectState"
},
"runtime_error_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Runtime Error Code"
},
"server_mappings": {
"additionalProperties": {
"type": "string"
},
"title": "Server Mappings",
"type": "object"
},
"slug": {
"title": "Slug",
"type": "string"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
}
},
"required": [
"id",
"name",
"slug",
"description",
"default_base_url",
"active_server_ref",
"server_mappings",
"mcp_hostname",
"is_enabled",
"active_build_id",
"active_deployment_id",
"created_by",
"created_at",
"updated_at",
"runtime_effect_state",
"runtime_command_id",
"runtime_error_code"
],
"title": "ProjectRead",
"type": "object"
},
"ProjectUpdate": {
"additionalProperties": false,
"properties": {
"active_server_ref": {
"anyOf": [
{
"maxLength": 120,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Active Server Ref"
},
"default_base_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Default Base Url"
},
"description": {
"anyOf": [
{
"maxLength": 10000,
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"is_enabled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Enabled"
},
"name": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
},
"server_mappings": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"title": "Server Mappings"
}
},
"title": "ProjectUpdate",
"type": "object"
},
"QueuedBuildAdmissionRead": {
"additionalProperties": false,
"properties": {
"admitted_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Admitted At"
},
"build_id": {
"format": "uuid",
"title": "Build Id",
"type": "string"
},
"lease_expires_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Lease Expires At"
},
"position": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Position"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"state": {
"$ref": "#/components/schemas/BuildAdmissionState"
},
"status": {
"$ref": "#/components/schemas/BuildStatus"
}
},
"required": [
"build_id",
"project_id",
"status",
"state",
"position",
"admitted_at",
"lease_expires_at"
],
"title": "QueuedBuildAdmissionRead",
"type": "object"
},
"ReadinessDependenciesRead": {
"additionalProperties": false,
"properties": {
"artifact_storage": {
"title": "Artifact Storage",
"type": "boolean"
},
"build_queue": {
"title": "Build Queue",
"type": "boolean"
},
"milvus": {
"title": "Milvus",
"type": "boolean"
},
"openrouter": {
"title": "Openrouter",
"type": "boolean"
},
"postgres": {
"title": "Postgres",
"type": "boolean"
},
"redis": {
"title": "Redis",
"type": "boolean"
}
},
"required": [
"postgres",
"redis",
"artifact_storage",
"build_queue",
"milvus",
"openrouter"
],
"title": "ReadinessDependenciesRead",
"type": "object"
},
"ReadinessRead": {
"additionalProperties": false,
"properties": {
"dependencies": {
"$ref": "#/components/schemas/ReadinessDependenciesRead"
},
"ready": {
"title": "Ready",
"type": "boolean"
}
},
"required": [
"ready",
"dependencies"
],
"title": "ReadinessRead",
"type": "object"
},
"RequestBodyMapping": {
"additionalProperties": false,
"properties": {
"media_type": {
"default": "application/json",
"enum": [
"application/json",
"application/x-www-form-urlencoded",
"multipart/form-data"
],
"title": "Media Type",
"type": "string"
},
"multipart_files": {
"items": {
"$ref": "#/components/schemas/MultipartFileMapping"
},
"title": "Multipart Files",
"type": "array"
},
"required": {
"default": false,
"title": "Required",
"type": "boolean"
},
"tool_field": {
"default": "body",
"title": "Tool Field",
"type": "string"
}
},
"title": "RequestBodyMapping",
"type": "object"
},
"RequestMapping": {
"additionalProperties": false,
"properties": {
"body": {
"anyOf": [
{
"$ref": "#/components/schemas/RequestBodyMapping"
},
{
"type": "null"
}
]
},
"method": {
"$ref": "#/components/schemas/HttpMethod"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/ParameterMapping"
},
"title": "Parameters",
"type": "array"
},
"path": {
"pattern": "^/",
"title": "Path",
"type": "string"
},
"server_ref": {
"title": "Server Ref",
"type": "string"
}
},
"required": [
"server_ref",
"method",
"path"
],
"title": "RequestMapping",
"type": "object"
},
"ResponseDefinition": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"media_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Media Type"
},
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/JsonObject"
},
{
"type": "null"
}
]
},
"status_code": {
"title": "Status Code",
"type": "string"
}
},
"required": [
"status_code"
],
"title": "ResponseDefinition",
"type": "object"
},
"RuntimeEffectState": {
"enum": [
"effective",
"pending",
"failed"
],
"title": "RuntimeEffectState",
"type": "string"
},
"RuntimeSecurity": {
"additionalProperties": false,
"properties": {
"allow_insecure_none_only_in_development": {
"default": true,
"title": "Allow Insecure None Only In Development",
"type": "boolean"
},
"allowed_upstream_hosts": {
"items": {
"type": "string"
},
"minItems": 1,
"title": "Allowed Upstream Hosts",
"type": "array"
},
"default_max_response_bytes": {
"default": 2000000,
"maximum": 50000000.0,
"minimum": 1024.0,
"title": "Default Max Response Bytes",
"type": "integer"
},
"default_timeout_ms": {
"default": 30000,
"maximum": 300000.0,
"minimum": 100.0,
"title": "Default Timeout Ms",
"type": "integer"
},
"inbound_auth_boundary": {
"const": "deployment_overlay",
"default": "deployment_overlay",
"title": "Inbound Auth Boundary",
"type": "string"
},
"inbound_auth_mode": {
"anyOf": [
{
"enum": [
"static_bearer",
"oidc",
"none"
],
"type": "string"
},
{
"type": "null"
}
],
"deprecated": true,
"title": "Inbound Auth Mode"
}
},
"required": [
"allowed_upstream_hosts"
],
"title": "RuntimeSecurity",
"type": "object"
},
"SecuritySchemeDiscoveryRead": {
"additionalProperties": false,
"properties": {
"advertised_scopes": {
"items": {
"type": "string"
},
"title": "Advertised Scopes",
"type": "array"
},
"applicable_operation_keys": {
"items": {
"type": "string"
},
"title": "Applicable Operation Keys",
"type": "array"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location"
},
"name": {
"title": "Name",
"type": "string"
},
"optional_for_all_operations": {
"title": "Optional For All Operations",
"type": "boolean"
},
"parameter_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Parameter Name"
},
"source_pointer": {
"title": "Source Pointer",
"type": "string"
},
"token_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Token Url"
},
"type": {
"title": "Type",
"type": "string"
}
},
"required": [
"name",
"type",
"location",
"parameter_name",
"token_url",
"advertised_scopes",
"applicable_operation_keys",
"optional_for_all_operations",
"source_pointer"
],
"title": "SecuritySchemeDiscoveryRead",
"type": "object"
},
"ServerCandidateRead": {
"additionalProperties": false,
"properties": {
"applicable_operation_keys": {
"items": {
"type": "string"
},
"title": "Applicable Operation Keys",
"type": "array"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"ref": {
"title": "Ref",
"type": "string"
},
"scope": {
"enum": [
"root",
"path",
"operation",
"project_default",
"inventory"
],
"title": "Scope",
"type": "string"
},
"source_pointer": {
"title": "Source Pointer",
"type": "string"
},
"url": {
"title": "Url",
"type": "string"
}
},
"required": [
"ref",
"url",
"description",
"scope",
"source_pointer",
"applicable_operation_keys"
],
"title": "ServerCandidateRead",
"type": "object"
},
"ServerDefinition": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Description"
},
"id": {
"title": "Id",
"type": "string"
},
"url": {
"format": "uri",
"minLength": 1,
"title": "Url",
"type": "string"
}
},
"required": [
"id",
"url"
],
"title": "ServerDefinition",
"type": "object"
},
"SourceConfigurationDiscoveryRead": {
"additionalProperties": false,
"properties": {
"configuration_sha256": {
"title": "Configuration Sha256",
"type": "string"
},
"operations": {
"items": {
"$ref": "#/components/schemas/OperationServerRoutingRead"
},
"title": "Operations",
"type": "array"
},
"routing_complete": {
"title": "Routing Complete",
"type": "boolean"
},
"security_requirements": {
"items": {
"$ref": "#/components/schemas/OperationSecurityRequirementRead"
},
"title": "Security Requirements",
"type": "array"
},
"security_schemes": {
"items": {
"$ref": "#/components/schemas/SecuritySchemeDiscoveryRead"
},
"title": "Security Schemes",
"type": "array"
},
"servers": {
"items": {
"$ref": "#/components/schemas/ServerCandidateRead"
},
"title": "Servers",
"type": "array"
},
"source_version_ids": {
"items": {
"format": "uuid",
"type": "string"
},
"title": "Source Version Ids",
"type": "array"
}
},
"required": [
"source_version_ids",
"configuration_sha256",
"servers",
"operations",
"security_schemes",
"security_requirements",
"routing_complete"
],
"title": "SourceConfigurationDiscoveryRead",
"type": "object"
},
"SourceCreate": {
"additionalProperties": false,
"properties": {
"is_primary": {
"default": false,
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"name": {
"maxLength": 200,
"minLength": 1,
"title": "Name",
"type": "string"
},
"origin_type": {
"$ref": "#/components/schemas/SourceOrigin"
},
"source_url": {
"anyOf": [
{
"format": "uri",
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Url"
}
},
"required": [
"kind",
"name",
"origin_type"
],
"title": "SourceCreate",
"type": "object"
},
"SourceCreationRead": {
"additionalProperties": false,
"properties": {
"source": {
"$ref": "#/components/schemas/SourceRead"
},
"version": {
"$ref": "#/components/schemas/SourceVersionRead"
}
},
"required": [
"source",
"version"
],
"title": "SourceCreationRead",
"type": "object"
},
"SourceIssueRead": {
"additionalProperties": false,
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"column": {
"anyOf": [
{
"minimum": 1.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Column"
},
"details": {
"$ref": "#/components/schemas/JsonObject"
},
"line": {
"anyOf": [
{
"minimum": 1.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Line"
},
"message": {
"title": "Message",
"type": "string"
},
"pointer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Pointer"
},
"severity": {
"enum": [
"error",
"warning",
"info"
],
"title": "Severity",
"type": "string"
},
"source_version_id": {
"format": "uuid",
"title": "Source Version Id",
"type": "string"
},
"stage": {
"title": "Stage",
"type": "string"
}
},
"required": [
"source_version_id",
"stage",
"code",
"severity",
"message",
"details"
],
"title": "SourceIssueRead",
"type": "object"
},
"SourceKind": {
"enum": [
"openapi",
"api_inventory",
"documentation"
],
"title": "SourceKind",
"type": "string"
},
"SourceOrigin": {
"enum": [
"upload",
"url"
],
"title": "SourceOrigin",
"type": "string"
},
"SourcePageRead": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SourceSummaryRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 100.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "SourcePageRead",
"type": "object"
},
"SourceRead": {
"additionalProperties": false,
"properties": {
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"current_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Version Id"
},
"current_version_selected_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Version Selected At"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_primary": {
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"last_observed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed At"
},
"last_observed_etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed Etag"
},
"last_observed_last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed Last Modified"
},
"name": {
"title": "Name",
"type": "string"
},
"origin_type": {
"$ref": "#/components/schemas/SourceOrigin"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Url"
}
},
"required": [
"id",
"project_id",
"kind",
"name",
"origin_type",
"source_url",
"is_primary",
"created_at",
"current_version_id",
"current_version_selected_at",
"last_observed_at",
"last_observed_etag",
"last_observed_last_modified"
],
"title": "SourceRead",
"type": "object"
},
"SourceSummaryRead": {
"additionalProperties": false,
"properties": {
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"current_version_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Version Id"
},
"current_version_selected_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Current Version Selected At"
},
"health": {
"enum": [
"missing",
"pending",
"valid",
"invalid"
],
"title": "Health",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_latest": {
"title": "Is Latest",
"type": "boolean"
},
"is_primary": {
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"last_observed_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed At"
},
"last_observed_etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed Etag"
},
"last_observed_last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Observed Last Modified"
},
"latest_version": {
"anyOf": [
{
"$ref": "#/components/schemas/SourceVersionSummaryRead"
},
{
"type": "null"
}
]
},
"name": {
"title": "Name",
"type": "string"
},
"origin_type": {
"$ref": "#/components/schemas/SourceOrigin"
},
"project_id": {
"format": "uuid",
"title": "Project Id",
"type": "string"
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Url"
},
"version_count": {
"minimum": 0.0,
"title": "Version Count",
"type": "integer"
}
},
"required": [
"id",
"project_id",
"kind",
"name",
"origin_type",
"source_url",
"is_primary",
"created_at",
"current_version_id",
"current_version_selected_at",
"last_observed_at",
"last_observed_etag",
"last_observed_last_modified",
"is_latest",
"latest_version",
"version_count",
"health"
],
"title": "SourceSummaryRead",
"type": "object"
},
"SourceUpdate": {
"additionalProperties": false,
"properties": {
"is_primary": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Primary"
},
"name": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Name"
}
},
"title": "SourceUpdate",
"type": "object"
},
"SourceUrlCreate": {
"additionalProperties": false,
"properties": {
"is_primary": {
"default": false,
"title": "Is Primary",
"type": "boolean"
},
"kind": {
"$ref": "#/components/schemas/SourceKind"
},
"name": {
"maxLength": 200,
"minLength": 1,
"title": "Name",
"type": "string"
},
"source_id": {
"format": "uuid",
"title": "Source Id",
"type": "string"
},
"source_url": {
"format": "uri",
"minLength": 1,
"title": "Source Url",
"type": "string"
}
},
"required": [
"source_id",
"kind",
"name",
"source_url"
],
"title": "SourceUrlCreate",
"type": "object"
},
"SourceVersionMetadataRead": {
"additionalProperties": false,
"properties": {
"auth_schemes": {
"items": {
"type": "string"
},
"title": "Auth Schemes",
"type": "array"
},
"byte_size": {
"title": "Byte Size",
"type": "integer"
},
"content_sha256": {
"title": "Content Sha256",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"deduplicated": {
"default": false,
"title": "Deduplicated",
"type": "boolean"
},
"detected_format": {
"title": "Detected Format",
"type": "string"
},
"embedding_dimensions": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Embedding Dimensions"
},
"embedding_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Embedding Model"
},
"errors": {
"items": {
"$ref": "#/components/schemas/SourceIssueRead"
},
"title": "Errors",
"type": "array"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"index_generation_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Index Generation Id"
},
"index_status": {
"anyOf": [
{
"$ref": "#/components/schemas/IndexGenerationStatus"
},
{
"type": "null"
}
]
},
"indexed_chunk_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Indexed Chunk Count"
},
"media_type": {
"title": "Media Type",
"type": "string"
},
"metadata_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Metadata Build Id"
},
"operation_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Operation Count"
},
"parse_status": {
"enum": [
"pending",
"valid",
"invalid"
],
"title": "Parse Status",
"type": "string"
},
"preview_markdown": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Preview Markdown"
},
"servers": {
"items": {
"type": "string"
},
"title": "Servers",
"type": "array"
},
"source_etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Etag"
},
"source_id": {
"format": "uuid",
"title": "Source Id",
"type": "string"
},
"source_last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Last Modified"
},
"spec_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Spec Version"
}
},
"required": [
"id",
"source_id",
"content_sha256",
"media_type",
"byte_size",
"detected_format",
"source_etag",
"source_last_modified",
"created_by",
"created_at",
"parse_status",
"spec_version",
"operation_count",
"servers",
"auth_schemes",
"errors",
"preview_markdown",
"indexed_chunk_count",
"embedding_model",
"embedding_dimensions",
"index_status",
"metadata_build_id",
"index_generation_id"
],
"title": "SourceVersionMetadataRead",
"type": "object"
},
"SourceVersionPageRead": {
"additionalProperties": false,
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SourceVersionRead"
},
"title": "Items",
"type": "array"
},
"page": {
"minimum": 1.0,
"title": "Page",
"type": "integer"
},
"page_size": {
"maximum": 100.0,
"minimum": 1.0,
"title": "Page Size",
"type": "integer"
},
"total": {
"minimum": 0.0,
"title": "Total",
"type": "integer"
}
},
"required": [
"items",
"total",
"page",
"page_size"
],
"title": "SourceVersionPageRead",
"type": "object"
},
"SourceVersionRead": {
"additionalProperties": false,
"properties": {
"byte_size": {
"title": "Byte Size",
"type": "integer"
},
"content_sha256": {
"title": "Content Sha256",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"deduplicated": {
"default": false,
"title": "Deduplicated",
"type": "boolean"
},
"detected_format": {
"title": "Detected Format",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"media_type": {
"title": "Media Type",
"type": "string"
},
"source_etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Etag"
},
"source_id": {
"format": "uuid",
"title": "Source Id",
"type": "string"
},
"source_last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Last Modified"
}
},
"required": [
"id",
"source_id",
"content_sha256",
"media_type",
"byte_size",
"detected_format",
"source_etag",
"source_last_modified",
"created_by",
"created_at"
],
"title": "SourceVersionRead",
"type": "object"
},
"SourceVersionSummaryRead": {
"additionalProperties": false,
"properties": {
"byte_size": {
"title": "Byte Size",
"type": "integer"
},
"content_sha256": {
"title": "Content Sha256",
"type": "string"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"created_by": {
"format": "uuid",
"title": "Created By",
"type": "string"
},
"deduplicated": {
"default": false,
"title": "Deduplicated",
"type": "boolean"
},
"detected_format": {
"title": "Detected Format",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"index_generation_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Index Generation Id"
},
"indexed_chunk_count": {
"anyOf": [
{
"minimum": 0.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Indexed Chunk Count"
},
"media_type": {
"title": "Media Type",
"type": "string"
},
"metadata_build_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Metadata Build Id"
},
"operation_count": {
"anyOf": [
{
"minimum": 0.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Operation Count"
},
"source_etag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Etag"
},
"source_id": {
"format": "uuid",
"title": "Source Id",
"type": "string"
},
"source_last_modified": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Last Modified"
}
},
"required": [
"id",
"source_id",
"content_sha256",
"media_type",
"byte_size",
"detected_format",
"source_etag",
"source_last_modified",
"created_by",
"created_at"
],
"title": "SourceVersionSummaryRead",
"type": "object"
},
"SystemSettingsRead": {
"additionalProperties": false,
"properties": {
"build_concurrency": {
"title": "Build Concurrency",
"type": "integer"
},
"build_retention_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Build Retention Count"
},
"builders_can_deploy": {
"title": "Builders Can Deploy",
"type": "boolean"
},
"environment": {
"enum": [
"development",
"production",
"test"
],
"title": "Environment",
"type": "string"
},
"max_document_chunks_per_project": {
"title": "Max Document Chunks Per Project",
"type": "integer"
},
"max_operations_per_project": {
"title": "Max Operations Per Project",
"type": "integer"
},
"max_upload_bytes": {
"title": "Max Upload Bytes",
"type": "integer"
},
"mcp_base_domain": {
"title": "Mcp Base Domain",
"type": "string"
},
"source_retention_days": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Retention Days"
}
},
"required": [
"builders_can_deploy",
"mcp_base_domain",
"build_concurrency",
"source_retention_days",
"build_retention_count",
"max_upload_bytes",
"max_operations_per_project",
"max_document_chunks_per_project",
"environment"
],
"title": "SystemSettingsRead",
"type": "object"
},
"SystemSettingsUpdate": {
"additionalProperties": false,
"properties": {
"build_concurrency": {
"maximum": 32.0,
"minimum": 1.0,
"title": "Build Concurrency",
"type": "integer"
},
"build_retention_count": {
"anyOf": [
{
"maximum": 10000.0,
"minimum": 1.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Build Retention Count"
},
"builders_can_deploy": {
"title": "Builders Can Deploy",
"type": "boolean"
},
"environment": {
"enum": [
"development",
"production",
"test"
],
"title": "Environment",
"type": "string"
},
"max_document_chunks_per_project": {
"maximum": 100000.0,
"minimum": 1.0,
"title": "Max Document Chunks Per Project",
"type": "integer"
},
"max_operations_per_project": {
"maximum": 100000.0,
"minimum": 1.0,
"title": "Max Operations Per Project",
"type": "integer"
},
"max_upload_bytes": {
"maximum": 100000000.0,
"minimum": 1024.0,
"title": "Max Upload Bytes",
"type": "integer"
},
"mcp_base_domain": {
"maxLength": 253,
"minLength": 1,
"title": "Mcp Base Domain",
"type": "string"
},
"source_retention_days": {
"anyOf": [
{
"maximum": 3650.0,
"minimum": 1.0,
"type": "integer"
},
{
"type": "null"
}
],
"title": "Source Retention Days"
}
},
"title": "SystemSettingsUpdate",
"type": "object"
},
"UserCreate": {
"additionalProperties": false,
"properties": {
"display_name": {
"maxLength": 160,
"minLength": 1,
"title": "Display Name",
"type": "string"
},
"email": {
"format": "email",
"title": "Email",
"type": "string"
},
"password": {
"format": "password",
"maxLength": 1024,
"minLength": 12,
"title": "Password",
"type": "string",
"writeOnly": true
},
"role": {
"$ref": "#/components/schemas/UserRole"
}
},
"required": [
"email",
"display_name",
"password",
"role"
],
"title": "UserCreate",
"type": "object"
},
"UserRead": {
"additionalProperties": false,
"properties": {
"created_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Created At"
},
"display_name": {
"title": "Display Name",
"type": "string"
},
"email": {
"format": "email",
"title": "Email",
"type": "string"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"is_active": {
"title": "Is Active",
"type": "boolean"
},
"last_login_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Last Login At"
},
"role": {
"$ref": "#/components/schemas/UserRole"
},
"updated_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "Updated At"
}
},
"required": [
"id",
"email",
"display_name",
"role",
"is_active"
],
"title": "UserRead",
"type": "object"
},
"UserRole": {
"enum": [
"admin",
"builder"
],
"title": "UserRole",
"type": "string"
},
"UserUpdate": {
"additionalProperties": false,
"properties": {
"display_name": {
"anyOf": [
{
"maxLength": 160,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
],
"title": "Display Name"
},
"is_active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Is Active"
},
"password": {
"anyOf": [
{
"format": "password",
"maxLength": 1024,
"minLength": 12,
"type": "string",
"writeOnly": true
},
{
"type": "null"
}
],
"title": "Password"
},
"role": {
"anyOf": [
{
"$ref": "#/components/schemas/UserRole"
},
{
"type": "null"
}
]
}
},
"title": "UserUpdate",
"type": "object"
},
"ValidationError": {
"properties": {
"ctx": {
"title": "Context",
"type": "object"
},
"input": {
"title": "Input"
},
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"title": "Location",
"type": "array"
},
"msg": {
"title": "Message",
"type": "string"
},
"type": {
"title": "Error Type",
"type": "string"
}
},
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError",
"type": "object"
},
"ValidationFindingRead": {
"additionalProperties": false,
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"details": {
"$ref": "#/components/schemas/JsonObject"
},
"message": {
"title": "Message",
"type": "string"
},
"operation_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Operation Key"
},
"severity": {
"$ref": "#/components/schemas/FindingSeverity"
},
"source_ref": {
"anyOf": [
{
"$ref": "#/components/schemas/ValidationSourceRefRead"
},
{
"type": "null"
}
]
},
"stage": {
"title": "Stage",
"type": "string"
}
},
"required": [
"code",
"severity",
"stage",
"operation_key",
"source_ref",
"message"
],
"title": "ValidationFindingRead",
"type": "object"
},
"ValidationReportRead": {
"additionalProperties": false,
"properties": {
"blocking_error_count": {
"title": "Blocking Error Count",
"type": "integer"
},
"build_id": {
"format": "uuid",
"title": "Build Id",
"type": "string"
},
"coverage_percent": {
"title": "Coverage Percent",
"type": "number"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"findings": {
"items": {
"$ref": "#/components/schemas/ValidationFindingRead"
},
"title": "Findings",
"type": "array"
},
"id": {
"format": "uuid",
"title": "Id",
"type": "string"
},
"operation_excluded_count": {
"title": "Operation Excluded Count",
"type": "integer"
},
"operation_expected_count": {
"title": "Operation Expected Count",
"type": "integer"
},
"operation_generated_count": {
"title": "Operation Generated Count",
"type": "integer"
},
"operation_source_count": {
"title": "Operation Source Count",
"type": "integer"
},
"overall_status": {
"$ref": "#/components/schemas/ValidationStatus"
},
"warning_count": {
"title": "Warning Count",
"type": "integer"
}
},
"required": [
"id",
"build_id",
"overall_status",
"operation_source_count",
"operation_excluded_count",
"operation_expected_count",
"operation_generated_count",
"coverage_percent",
"blocking_error_count",
"warning_count",
"findings",
"created_at"
],
"title": "ValidationReportRead",
"type": "object"
},
"ValidationSourceRefRead": {
"additionalProperties": false,
"properties": {
"path": {
"title": "Path",
"type": "string"
},
"source_version_id": {
"format": "uuid",
"title": "Source Version Id",
"type": "string"
}
},
"required": [
"source_version_id",
"path"
],
"title": "ValidationSourceRefRead",
"type": "object"
},
"ValidationStatus": {
"enum": [
"pass",
"fail"
],
"title": "ValidationStatus",
"type": "string"
}
}
},
"info": {
"description": "Self-hosted API-to-MCP builder/control plane",
"title": "MCPlica API",
"version": "1.0.0-rc.2"
},
"openapi": "3.1.0",
"paths": {
"/api/v1/audit": {
"get": {
"operationId": "list_audit_api_v1_audit_get",
"parameters": [
{
"in": "query",
"name": "actor",
"required": false,
"schema": {
"anyOf": [
{
"maxLength": 320,
"type": "string"
},
{
"type": "null"
}
],
"title": "Actor"
}
},
{
"in": "query",
"name": "project_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Project Id"
}
},
{
"in": "query",
"name": "event_type",
"required": false,
"schema": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"title": "Event Type"
}
},
{
"in": "query",
"name": "from",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "From"
}
},
{
"in": "query",
"name": "to",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "To"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AuditPage"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Audit",
"tags": [
"audit"
]
}
},
"/api/v1/auth/login": {
"post": {
"operationId": "login_api_v1_auth_login_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/LoginRequest"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AuthResponse"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Login",
"tags": [
"authentication"
]
}
},
"/api/v1/auth/logout": {
"post": {
"operationId": "logout_api_v1_auth_logout_post",
"responses": {
"204": {
"description": "Successful Response"
}
},
"summary": "Logout",
"tags": [
"authentication"
]
}
},
"/api/v1/auth/me": {
"get": {
"operationId": "me_api_v1_auth_me_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Me",
"tags": [
"authentication"
]
}
},
"/api/v1/auth/refresh": {
"post": {
"operationId": "refresh_api_v1_auth_refresh_post",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AuthResponse"
}
}
},
"description": "Successful Response"
}
},
"summary": "Refresh",
"tags": [
"authentication"
]
}
},
"/api/v1/build-admission": {
"get": {
"operationId": "get_build_admission_api_v1_build_admission_get",
"parameters": [
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"default": 200,
"maximum": 200,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildAdmissionOverviewRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Admission",
"tags": [
"builds"
]
}
},
"/api/v1/builds": {
"get": {
"operationId": "list_builds_api_v1_builds_get",
"parameters": [
{
"in": "query",
"name": "project_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Project Id"
}
},
{
"in": "query",
"name": "status",
"required": false,
"schema": {
"anyOf": [
{
"$ref": "#/components/schemas/BuildStatus"
},
{
"type": "null"
}
],
"title": "Status"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildPageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Builds",
"tags": [
"builds"
]
}
},
"/api/v1/builds/metrics": {
"get": {
"operationId": "get_build_metrics_api_v1_builds_metrics_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildMetricsRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Get Build Metrics",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}": {
"get": {
"operationId": "get_build_api_v1_builds__build_id__get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/ai-runs": {
"get": {
"operationId": "get_build_ai_runs_api_v1_builds__build_id__ai_runs_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_BuildAIRunRead_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Ai Runs",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/cancel": {
"post": {
"operationId": "cancel_build_api_v1_builds__build_id__cancel_post",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Cancel Build",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/diff": {
"get": {
"operationId": "get_build_diff_api_v1_builds__build_id__diff_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildDiffRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Diff",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/events": {
"get": {
"operationId": "build_events_api_v1_builds__build_id__events_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Build Events",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/export": {
"get": {
"operationId": "export_build_api_v1_builds__build_id__export_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Export Build",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/manifest": {
"get": {
"operationId": "get_build_manifest_api_v1_builds__build_id__manifest_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPManifest"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Manifest",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/manifest/download": {
"get": {
"operationId": "download_build_manifest_api_v1_builds__build_id__manifest_download_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Download Build Manifest",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/operations": {
"get": {
"operationId": "get_build_operations_api_v1_builds__build_id__operations_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
},
{
"in": "query",
"name": "search",
"required": false,
"schema": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"title": "Search"
}
},
{
"in": "query",
"name": "method",
"required": false,
"schema": {
"anyOf": [
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD",
"OPTIONS",
"TRACE"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Method"
}
},
{
"in": "query",
"name": "scope",
"required": false,
"schema": {
"default": "all",
"enum": [
"all",
"current-included",
"current-excluded",
"build-excluded",
"changed"
],
"title": "Scope",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OperationPageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Operations",
"tags": [
"builds"
]
}
},
"/api/v1/builds/{build_id}/validation": {
"get": {
"operationId": "get_build_validation_api_v1_builds__build_id__validation_get",
"parameters": [
{
"in": "path",
"name": "build_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Build Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ValidationReportRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Build Validation",
"tags": [
"builds"
]
}
},
"/api/v1/cleanup-jobs": {
"get": {
"operationId": "list_cleanup_jobs_api_v1_cleanup_jobs_get",
"parameters": [
{
"in": "query",
"name": "project_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Project Id"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"default": 100,
"maximum": 500,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/CleanupJobRead"
},
"title": "Response List Cleanup Jobs Api V1 Cleanup Jobs Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Cleanup Jobs",
"tags": [
"cleanup"
]
}
},
"/api/v1/cleanup-jobs/{job_id}": {
"get": {
"operationId": "get_cleanup_job_api_v1_cleanup_jobs__job_id__get",
"parameters": [
{
"in": "path",
"name": "job_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Job Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CleanupJobRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Cleanup Job",
"tags": [
"cleanup"
]
}
},
"/api/v1/deployments/{deployment_id}": {
"get": {
"operationId": "get_deployment_api_v1_deployments__deployment_id__get",
"parameters": [
{
"in": "path",
"name": "deployment_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Deployment Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Deployment",
"tags": [
"deployments"
]
}
},
"/api/v1/deployments/{deployment_id}/events": {
"get": {
"operationId": "deployment_events_api_v1_deployments__deployment_id__events_get",
"parameters": [
{
"in": "path",
"name": "deployment_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Deployment Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Deployment Events",
"tags": [
"deployments"
]
}
},
"/api/v1/deployments/{deployment_id}/restart": {
"post": {
"operationId": "restart_deployment_api_v1_deployments__deployment_id__restart_post",
"parameters": [
{
"in": "path",
"name": "deployment_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Deployment Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Restart Deployment",
"tags": [
"deployments"
]
}
},
"/api/v1/deployments/{deployment_id}/stop": {
"post": {
"operationId": "stop_deployment_api_v1_deployments__deployment_id__stop_post",
"parameters": [
{
"in": "path",
"name": "deployment_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Deployment Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Stop Deployment",
"tags": [
"deployments"
]
}
},
"/api/v1/health": {
"get": {
"operationId": "health_api_v1_health_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HealthRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Health",
"tags": [
"system"
]
}
},
"/api/v1/projects": {
"get": {
"operationId": "list_projects_api_v1_projects_get",
"parameters": [
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_ProjectRead_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Projects",
"tags": [
"projects"
]
},
"post": {
"operationId": "create_project_api_v1_projects_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Project",
"tags": [
"projects"
]
}
},
"/api/v1/projects/{project_id}": {
"delete": {
"operationId": "delete_project_api_v1_projects__project_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CleanupJobRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Delete Project",
"tags": [
"projects"
]
},
"get": {
"operationId": "get_project_api_v1_projects__project_id__get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Project",
"tags": [
"projects"
]
},
"patch": {
"operationId": "update_project_api_v1_projects__project_id__patch",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Project",
"tags": [
"projects"
]
}
},
"/api/v1/projects/{project_id}/builds": {
"get": {
"operationId": "list_project_builds_api_v1_projects__project_id__builds_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 100,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildPageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Project Builds",
"tags": [
"builds"
]
},
"post": {
"operationId": "create_build_api_v1_projects__project_id__builds_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildCreate"
}
}
},
"required": true
},
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Build",
"tags": [
"builds"
]
}
},
"/api/v1/projects/{project_id}/credentials": {
"get": {
"operationId": "list_credentials_api_v1_projects__project_id__credentials_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_CredentialRead_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Credentials",
"tags": [
"credentials"
]
},
"post": {
"operationId": "create_credential_api_v1_projects__project_id__credentials_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CredentialCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CredentialRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Credential",
"tags": [
"credentials"
]
}
},
"/api/v1/projects/{project_id}/credentials/{credential_id}": {
"delete": {
"operationId": "revoke_credential_api_v1_projects__project_id__credentials__credential_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "credential_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Credential Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CredentialRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Revoke Credential",
"tags": [
"credentials"
]
}
},
"/api/v1/projects/{project_id}/credentials/{credential_id}/rotate": {
"post": {
"operationId": "rotate_credential_api_v1_projects__project_id__credentials__credential_id__rotate_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "credential_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Credential Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CredentialRotate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CredentialRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Rotate Credential",
"tags": [
"credentials"
]
}
},
"/api/v1/projects/{project_id}/deployments": {
"get": {
"operationId": "list_deployments_api_v1_projects__project_id__deployments_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentPageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Deployments",
"tags": [
"deployments"
]
},
"post": {
"operationId": "create_deployment_api_v1_projects__project_id__deployments_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentCreate"
}
}
},
"required": true
},
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Deployment",
"tags": [
"deployments"
]
}
},
"/api/v1/projects/{project_id}/journey": {
"get": {
"operationId": "get_project_journey_api_v1_projects__project_id__journey_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "build_id",
"required": false,
"schema": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"title": "Build Id"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProjectJourneyRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Project Journey",
"tags": [
"projects"
]
}
},
"/api/v1/projects/{project_id}/mcp-access": {
"get": {
"operationId": "get_mcp_access_api_v1_projects__project_id__mcp_access_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Mcp Access",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/mcp-access/auth-mode": {
"put": {
"operationId": "update_auth_mode_api_v1_projects__project_id__mcp_access_auth_mode_put",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAuthConfigUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAuthConfigRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Auth Mode",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/mcp-access/status": {
"get": {
"operationId": "get_mcp_access_status_api_v1_projects__project_id__mcp_access_status_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessStatusRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Get Mcp Access Status",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/mcp-access/tokens": {
"post": {
"operationId": "create_access_token_api_v1_projects__project_id__mcp_access_tokens_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessTokenCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessTokenIssued"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Access Token",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/mcp-access/tokens/{token_id}": {
"delete": {
"operationId": "revoke_access_token_api_v1_projects__project_id__mcp_access_tokens__token_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "token_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Token Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessTokenRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Revoke Access Token",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/mcp-access/tokens/{token_id}/rotate": {
"post": {
"operationId": "rotate_access_token_api_v1_projects__project_id__mcp_access_tokens__token_id__rotate_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "token_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Token Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessTokenRotate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MCPAccessTokenIssued"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Rotate Access Token",
"tags": [
"mcp-access"
]
}
},
"/api/v1/projects/{project_id}/operation-exclusions": {
"get": {
"operationId": "list_operation_exclusions_api_v1_projects__project_id__operation_exclusions_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/OperationExclusionRead"
},
"title": "Response List Operation Exclusions Api V1 Projects Project Id Operation Exclusions Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Operation Exclusions",
"tags": [
"builds"
]
},
"post": {
"operationId": "create_operation_exclusion_api_v1_projects__project_id__operation_exclusions_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OperationExclusionCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OperationExclusionRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Operation Exclusion",
"tags": [
"builds"
]
}
},
"/api/v1/projects/{project_id}/operation-exclusions/{exclusion_id}": {
"delete": {
"operationId": "delete_operation_exclusion_api_v1_projects__project_id__operation_exclusions__exclusion_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "exclusion_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Exclusion Id",
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Delete Operation Exclusion",
"tags": [
"builds"
]
}
},
"/api/v1/projects/{project_id}/rebuild": {
"post": {
"operationId": "rebuild_project_api_v1_projects__project_id__rebuild_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Rebuild Project",
"tags": [
"builds"
]
}
},
"/api/v1/projects/{project_id}/review": {
"post": {
"operationId": "review_project_api_v1_projects__project_id__review_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BuildRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Review Project",
"tags": [
"builds"
]
}
},
"/api/v1/projects/{project_id}/rollback": {
"post": {
"operationId": "rollback_deployment_api_v1_projects__project_id__rollback_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRollback"
}
}
},
"required": true
},
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/DeploymentRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Rollback Deployment",
"tags": [
"deployments"
]
}
},
"/api/v1/projects/{project_id}/source-configuration": {
"get": {
"operationId": "discover_source_configuration_api_v1_projects__project_id__source_configuration_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceConfigurationDiscoveryRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Discover Source Configuration",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources": {
"get": {
"operationId": "list_sources_api_v1_projects__project_id__sources_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
{
"in": "query",
"name": "include_superseded",
"required": false,
"schema": {
"default": false,
"title": "Include Superseded",
"type": "boolean"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourcePageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Sources",
"tags": [
"sources"
]
},
"post": {
"operationId": "create_source_api_v1_projects__project_id__sources_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Source",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources/upload": {
"post": {
"operationId": "create_upload_source_with_first_version_api_v1_projects__project_id__sources_upload_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_create_upload_source_with_first_version_api_v1_projects__project_id__sources_upload_post"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceCreationRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Upload Source With First Version",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources/url": {
"post": {
"operationId": "create_url_source_with_first_version_api_v1_projects__project_id__sources_url_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceUrlCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceCreationRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create Url Source With First Version",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources/{source_id}": {
"delete": {
"operationId": "delete_source_api_v1_projects__project_id__sources__source_id__delete",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "source_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
}
],
"responses": {
"202": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CleanupJobRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Delete Source",
"tags": [
"sources"
]
},
"patch": {
"operationId": "update_source_api_v1_projects__project_id__sources__source_id__patch",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "source_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Source",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources/{source_id}/refresh": {
"post": {
"operationId": "refresh_source_api_v1_projects__project_id__sources__source_id__refresh_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "source_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceVersionRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Refresh Source",
"tags": [
"sources"
]
}
},
"/api/v1/projects/{project_id}/sources/{source_id}/versions": {
"get": {
"operationId": "list_source_versions_api_v1_projects__project_id__sources__source_id__versions_get",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "source_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 25,
"maximum": 100,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceVersionPageRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Source Versions",
"tags": [
"sources"
]
},
"post": {
"operationId": "upload_source_version_api_v1_projects__project_id__sources__source_id__versions_post",
"parameters": [
{
"in": "path",
"name": "project_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Project Id",
"type": "string"
}
},
{
"in": "path",
"name": "source_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Source Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"$ref": "#/components/schemas/Body_upload_source_version_api_v1_projects__project_id__sources__source_id__versions_post"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceVersionRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Upload Source Version",
"tags": [
"sources"
]
}
},
"/api/v1/ready": {
"get": {
"operationId": "ready_api_v1_ready_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReadinessRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Ready",
"tags": [
"system"
]
}
},
"/api/v1/settings": {
"get": {
"operationId": "get_settings_api_v1_settings_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemSettingsRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Get Settings",
"tags": [
"settings"
]
},
"patch": {
"operationId": "update_settings_api_v1_settings_patch",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemSettingsUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SystemSettingsRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Settings",
"tags": [
"settings"
]
}
},
"/api/v1/settings/models": {
"get": {
"operationId": "get_models_api_v1_settings_models_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ModelSettingsRead"
}
}
},
"description": "Successful Response"
}
},
"summary": "Get Models",
"tags": [
"settings"
]
},
"put": {
"operationId": "update_models_api_v1_settings_models_put",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ModelSettingsUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ModelSettingsRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Models",
"tags": [
"settings"
]
}
},
"/api/v1/settings/models/catalog": {
"get": {
"operationId": "model_catalog_api_v1_settings_models_catalog_get",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/ModelCatalogItem"
},
"title": "Response Model Catalog Api V1 Settings Models Catalog Get",
"type": "array"
}
}
},
"description": "Successful Response"
}
},
"summary": "Model Catalog",
"tags": [
"settings"
]
}
},
"/api/v1/settings/openrouter": {
"put": {
"operationId": "update_openrouter_api_v1_settings_openrouter_put",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpenRouterSecretUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ModelSettingsRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update Openrouter",
"tags": [
"settings"
]
}
},
"/api/v1/settings/openrouter/test": {
"post": {
"operationId": "test_openrouter_api_v1_settings_openrouter_test_post",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/OpenRouterTestResult"
}
}
},
"description": "Successful Response"
}
},
"summary": "Test Openrouter",
"tags": [
"settings"
]
}
},
"/api/v1/source-versions/{version_id}/metadata": {
"get": {
"operationId": "source_version_metadata_api_v1_source_versions__version_id__metadata_get",
"parameters": [
{
"in": "path",
"name": "version_id",
"required": true,
"schema": {
"format": "uuid",
"title": "Version Id",
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SourceVersionMetadataRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Source Version Metadata",
"tags": [
"sources"
]
}
},
"/api/v1/usage/by-model": {
"get": {
"operationId": "usage_by_model_api_v1_usage_by_model_get",
"parameters": [
{
"in": "query",
"name": "from",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "From"
}
},
{
"in": "query",
"name": "to",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "To"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"items": {
"$ref": "#/components/schemas/ModelUsageRead"
},
"title": "Response Usage By Model Api V1 Usage By Model Get",
"type": "array"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Usage By Model",
"tags": [
"usage"
]
}
},
"/api/v1/usage/logs": {
"get": {
"operationId": "usage_logs_api_v1_usage_logs_get",
"parameters": [
{
"in": "query",
"name": "model",
"required": true,
"schema": {
"minLength": 1,
"title": "Model",
"type": "string"
}
},
{
"in": "query",
"name": "from",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "From"
}
},
{
"in": "query",
"name": "to",
"required": false,
"schema": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"title": "To"
}
},
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_BuildAIRunRead_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Usage Logs",
"tags": [
"usage"
]
}
},
"/api/v1/users": {
"get": {
"operationId": "list_users_api_v1_users_get",
"parameters": [
{
"in": "query",
"name": "page",
"required": false,
"schema": {
"default": 1,
"minimum": 1,
"title": "Page",
"type": "integer"
}
},
{
"in": "query",
"name": "page_size",
"required": false,
"schema": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Page_UserRead_"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "List Users",
"tags": [
"users"
]
},
"post": {
"operationId": "create_user_api_v1_users_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserCreate"
}
}
},
"required": true
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Create User",
"tags": [
"users"
]
}
},
"/api/v1/users/{user_id}": {
"patch": {
"operationId": "update_user_api_v1_users__user_id__patch",
"parameters": [
{
"in": "path",
"name": "user_id",
"required": true,
"schema": {
"format": "uuid",
"title": "User Id",
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserUpdate"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UserRead"
}
}
},
"description": "Successful Response"
},
"422": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/HTTPValidationError"
}
}
},
"description": "Validation Error"
}
},
"summary": "Update User",
"tags": [
"users"
]
}
}
}
}