{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://monomer.cc/schemas/agent-workspace/v1", "title": "Agent Workspace REST contract", "description": "Strict request and response schemas for the six Agent Workspace operations. Credentials are verified before request-body decoding; admission follows decoding. Invalid credentials return 401, missing targets or membership 404, insufficient roles 403 ROLE_REQUIRED, concurrency conflicts 409, and input value errors 400. Retryable unavailability returns 503 with Retry-After; non-retryable 503 omits it. Unexpected owner failures use OWNER_UNAVAILABLE; unconfirmed non-idempotent creates and starts require reading before resending. AGENT_OWNER_RESPONSE_INVALID is reserved for public response contract violations. Unexpected owner IllegalArgumentException and Semantic engine faults are logged and return 500 INTERNAL_ERROR. Unsupported Semantic engine capabilities return 400 SEMANTIC_QUERY_UNSUPPORTED on Explore and Semantic check; thrown invalid Semantic queries use SEMANTIC_QUERY_INVALID on Explore and Semantic check. Ordinary check findings remain successful check data. Engine diagnostics are not exposed. For a categorical Semantic query filter on a plain-column dimension with a known current Catalog text, number, or boolean type, the filter kind must match that column type. A contradiction returns an input error with QUERY_FILTER_UNRENDERABLE at input.query.filters[i].kind; computed expressions and unknown types keep explicit caller-selected comparison types. Time dimensions keep their grain-based behavior.", "$ref": "#/$defs/AgentResourceEnvelope", "$defs": { "Uuid": { "type": "string", "format": "uuid", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "description": "Canonical lowercase hyphenated UUID." }, "AgentMetricSourceConnector": { "description": "ID and current display name of a source-definition candidate in this Workspace. Deleted and other-Workspace Connectors are excluded.", "type": "object", "additionalProperties": false, "required": ["connectorId", "displayName"], "properties": { "connectorId": { "$ref": "#/$defs/Uuid" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/PostgresqlRead/properties/displayName" } } }, "UuidV7": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "AgentActor": { "description": "A recorded person as the Web shows them. displayName is null for an unreadable account. Provenance fields are absent when nothing was recorded.", "type": "object", "additionalProperties": false, "required": ["id", "displayName"], "properties": {"id": {"type": "string", "minLength": 1}, "displayName": {"type": ["string", "null"]}} }, "AgentApp": { "description": "The agent app behind AGENT work (via {name}); name is self-asserted, verifiedHost is the host Monomer verified. Absent for WEB work and unknown apps.", "type": "object", "additionalProperties": false, "required": ["clientId", "name", "verifiedHost"], "properties": {"clientId": {"type": "string", "minLength": 1, "maxLength": 2048}, "name": {"type": "string"}, "verifiedHost": {"type": ["string", "null"]}} }, "CredentialSurface": {"description": "WEB for work in the app, AGENT for work through an agent connection.", "enum": ["WEB", "AGENT"]}, "PageActor": { "description": "Who did Pages work. displayName is null for SYSTEM and for an unreadable account.", "type": "object", "additionalProperties": false, "required": ["kind", "id", "displayName"], "properties": {"kind": {"enum": ["USER", "AGENT", "SYSTEM"]}, "id": {"type": "string", "minLength": 1}, "displayName": {"type": ["string", "null"]}, "agentApp": {"$ref": "#/$defs/AgentApp"}} }, "RevisionString": { "type": "string", "pattern": "^(?:0|[1-9][0-9]{0,18})$", "maxLength": 19 }, "RequestId": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[A-Za-z0-9._:-]+$" }, "CanonicalResourcePath": { "type": "string", "minLength": 7, "maxLength": 6257, "pattern": "^(?:workspace|organization)(?:/[^\\u0000-\\u001F\\u007F-\\u009F]*[^/\\u0000-\\u001F\\u007F-\\u009F])?(?![\\s\\S])$", "not": { "pattern": "~(?![01])|//" }, "description": "Relative resource address rooted at workspace or the explicitly targeted Organization. UUID identity segments use canonical lowercase hyphenated UUIDs. Names use ~0 for ~ and ~1 for /. Empty segments and trailing slash are forbidden." }, "AgentResourceKind": { "enum": [ "COLLECTION", "CONNECTOR", "CATALOG_ROOT", "CATALOG", "CONNECTOR_CATALOG_SELECTION", "CATALOG_SELECTION", "CATALOG_SELECTION_OPTION", "CATALOG_SELECTION_OPTION_REFRESH", "CATALOG_INGESTION", "CATALOG_INGESTION_FAILURE", "SCHEMA", "RELATION", "SEMANTIC_MODEL", "METRIC", "EXPLORE_RUN", "EXPLORE_RESULT", "DASHBOARD", "DASHBOARD_DRAFT", "DASHBOARD_DRAFT_STATUS", "DASHBOARD_SESSION", "DASHBOARD_QUERY_RUN", "DASHBOARD_QUERY_RESULT", "PAGE", "PAGES_TREE", "PAGE_VERSION", "PAGE_CONTENT_UPLOAD", "ORGANIZATION", "ORGANIZATION_MEMBER", "ORGANIZATION_INVITATION", "WORKSPACE_MEMBER", "WORKSPACE_ACCESS", "WORKSPACE_AUTHORIZATION", "LINEAGE_RESOURCE", "DASHBOARD_SCHEDULES", "DASHBOARD_SCHEDULE_OCCURRENCE", "PAGE_CONTENT", "PAGE_SESSION", "PAGE_QUERY_RUN", "SEMANTIC_MODEL_VERSION", "METRIC_VERSION", "DASHBOARD_VERSION" ] }, "AgentWorkspaceOperation": { "enum": ["LIST", "SEARCH", "READ", "CREATE", "EDIT", "INVOKE"] }, "AgentListRequest": { "type": "object", "additionalProperties": false, "required": ["path", "limit"], "properties": { "path": { "$ref": "#/$defs/CanonicalResourcePath" }, "cursor": { "type": "string", "maxLength": 6990, "description": "Opaque continuation returned by this collection. Dashboard Session cursors belong to the exact Dashboard collection path; using one with another Dashboard returns 400 CURSOR_INVALID." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Required page size for every Workspace or Organization resource listing. Use an integer from 1 to 100, for example 20; no default is applied." } } }, "AgentSearchRequest": { "type": "object", "description": "Search names and descriptions, or Page display titles with every whitespace-separated query word as a case-insensitive substring. Page descriptions and content are excluded. workspace/pages or workspace with kinds [PAGE] allows Viewer: current placed Pages and reader metadata only. Explorer or higher also sees unplaced Pages. Other searches require Explorer or higher. Direct membership is required; deleted Pages are excluded. Omitted kinds searches all supported kinds in scope. Mixed results append Pages after ranked metadata within limitPerQuery; query order is preserved, no cursor.", "additionalProperties": false, "required": ["path", "queries", "limitPerQuery"], "properties": { "path": { "$ref": "#/$defs/CanonicalResourcePath" }, "queries": { "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "\\S" } }, "kinds": { "type": "array", "minItems": 1, "maxItems": 8, "uniqueItems": true, "items": { "enum": ["CONNECTOR", "CATALOG", "SCHEMA", "RELATION", "SEMANTIC_MODEL", "METRIC", "DASHBOARD", "PAGE"] } }, "limitPerQuery": { "type": "integer", "minimum": 1, "maximum": 20 } } }, "AgentSearchResponse": { "type": "object", "additionalProperties": false, "required": ["requestId", "results"], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "results": { "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "object", "additionalProperties": false, "required": ["query", "items"], "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 1024 }, "items": { "type": "array", "maxItems": 20, "items": { "$ref": "#/$defs/AgentResourceListingItem" } } } } } } }, "AgentReadRequest": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": ["path"], "properties": { "path": { "$ref": "#/$defs/CanonicalResourcePath" } } }, { "type": "object", "additionalProperties": false, "required": ["path", "download"], "properties": { "path": { "$ref": "#/$defs/ExploreResultResourcePath" }, "download": { "const": "arrow", "description": "Request a short-lived GET reference to the original Arrow artifact. Preview columns remain canonical; original Semantic Arrow columns retain internal aliases." } } } ] }, "AgentCreateRequest": { "oneOf": [ { "$ref": "#/$defs/SemanticModelCreateRequest" }, { "$ref": "#/$defs/MetricCreateRequest" }, { "$ref": "#/$defs/DashboardCreateRequest" }, { "$ref": "#/$defs/ConnectorCreateRequest" }, { "$ref": "#/$defs/FolderPageCreateRequest" }, { "$ref": "#/$defs/DocumentPageCreateRequest" }, { "$ref": "#/$defs/DashboardPageCreateRequest" }, { "$ref": "#/$defs/PageVersionCreateRequest" }, { "$ref": "#/$defs/PageUploadCreateRequest" }, { "$ref": "#/$defs/OrganizationInvitationCreateRequest" } ] }, "SemanticModelCreateRequest": { "type": "object", "additionalProperties": false, "required": ["path", "input"], "properties": { "path": { "const": "workspace/semantic-models" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "definition", "aggregateMetrics" ], "properties": { "kind": { "const": "SEMANTIC_MODEL_DEFINITION" }, "definition": { "$ref": "monomer://schema/semantic/model/3" }, "aggregateMetrics": { "type": "array", "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/aggregateMetric" } } } } } }, "MetricCreateRequest": { "type": "object", "additionalProperties": false, "required": ["path", "input"], "properties": { "path": { "const": "workspace/metrics" }, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "definition"], "properties": { "kind": { "const": "METRIC_DEFINITION" }, "definition": { "$ref": "monomer://schema/semantic/metric/3" } } } } }, "DashboardCreateRequest": { "type": "object", "additionalProperties": false, "required": ["path", "input"], "properties": { "path": {"const": "workspace/dashboards"}, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "definition"], "properties": {"kind": {"const": "DASHBOARD_DEFINITION"}, "definition": {"$ref": "monomer://schema/dashboard/1"}} } } }, "AgentEditRequest": { "description": "One of the five edit requests, selected by path. patch is a single atomic change applied in order to the owner's editable document, not the read envelope. Intermediate documents during partial operations may be incomplete; after all operations the owner validates the final document and its current resource relationships, then saves once. requestId, kind, path, revision, availableOperations, and server execution and time fields are not part of the editable document.", "oneOf": [ { "$ref": "#/$defs/SemanticModelEditRequest" }, { "$ref": "#/$defs/MetricEditRequest" }, { "$ref": "#/$defs/DashboardDraftEditRequest" }, { "$ref": "#/$defs/ConnectorCatalogSelectionEditRequest" }, { "$ref": "#/$defs/CatalogSelectionEditRequest" }, { "$ref": "#/$defs/ConnectorEditRequest" }, { "$ref": "#/$defs/PageMetadataEditRequest" }, { "$ref": "#/$defs/PagesTreeEditRequest" } ] }, "SemanticModelEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "patch", "aggregateMetrics" ], "properties": { "revision": false, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "patch": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/$defs/SemanticModelPatchOperation" } }, "aggregateMetrics": { "type": "array", "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/aggregateMetric" } } }, "description": "Edits the Semantic Model definition itself. Last-write-wins; revision is not accepted, not even null. root can only be replaced with a complete owner model definition. name and stable identity are immutable, and the final name must equal the current name in the path. Replacing root with the same name, and operations that set identity fields to their current values, are allowed. Unresolved references don't block saving and don't guarantee that the model can run. The required aggregateMetrics array creates only explicitly requested new simple metrics in the same transaction as the model edit; use [] for none. Existing metrics are untouched.", "examples": [ { "path": "workspace/semantic-models/orders", "patch": [ { "op": "replace", "path": "/sourceRelations/0/relation", "value": "orders_v2" } ], "aggregateMetrics": [] } ] }, "MetricEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "patch" ], "properties": { "revision": false, "path": { "$ref": "#/$defs/MetricResourcePath" }, "patch": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/$defs/MetricPatchOperation" } } }, "description": "Edits the Metric definition itself. Last-write-wins; revision is not accepted, not even null. root can only be replaced with a complete owner metric definition. name and stable identity are immutable, and the final name must equal the current name in the path. Replacing root with the same name, and operations that set identity fields to their current values, are allowed. Partial paths are the union of the root fields of the five Metric types, and an intermediate document while switching types may be incomplete. Unresolved or cyclic references can be saved and are validated again at run time.", "examples": [ { "path": "workspace/metrics/revenue", "patch": [ { "op": "remove", "path": "/measure" }, { "op": "add", "path": "/measure", "value": "net_revenue" } ] } ] }, "DashboardDraftEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "revision", "patch" ], "properties": { "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "revision": { "$ref": "#/$defs/RevisionString" }, "patch": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/$defs/DashboardDraftPatchOperation" } } }, "description": "Edits only definition, parameterBindings, and variables of the read body. A single compare-and-set: submit the read envelope's authoring revision as the required string revision. root can only be replaced with a complete editable document containing all three fields. The owner validates the definition's DSL and that complete bindings and variables match the declared keys and types. Server-managed targetQueryRuns, readyResults, timestamps, and identity can't be edited.", "examples": [ { "path": "workspace/dashboards/0198ef28-2000-7000-8000-000000000001/draft", "revision": "3", "patch": [ { "op": "replace", "path": "/definition/meta/title", "value": "Revenue overview" } ] } ] }, "ConnectorCatalogSelectionEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "patch" ], "properties": { "revision": false, "path": { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" }, "patch": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "$ref": "#/$defs/ConnectorCatalogSelectionPatchOperation" } } }, "description": "Last-write-wins; revision is not accepted, not even null. Replaces the whole Connector Catalog selection document with one replace whose path is the empty string. An empty selectedCatalogNames array clears the selection.", "examples": [ { "path": "workspace/connectors/0198ef28-1000-7000-8000-000000000001/catalog/catalog-selection", "patch": [ { "op": "replace", "path": "", "value": { "selectedCatalogNames": [] } } ] } ] }, "CatalogSelectionEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "patch" ], "properties": { "revision": false, "path": { "$ref": "#/$defs/CatalogSelectionResourcePath" }, "patch": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "$ref": "#/$defs/CatalogSelectionPatchOperation" } } }, "description": "Last-write-wins; revision is not accepted, not even null. Replaces the whole Catalog selection document with one replace whose path is the empty string. An empty selectedSchemas array, or an empty relationNames array for SELECTED_RELATIONS, is a valid empty selection.", "examples": [ { "path": "workspace/connectors/0198ef28-1000-7000-8000-000000000001/catalog/selection", "patch": [ { "op": "replace", "path": "", "value": { "selectedSchemas": [] } } ] } ] }, "SemanticModelPatchOperation": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "monomer://schema/semantic/model/3" } } }, { "allOf": [ { "$ref": "#/$defs/AgentJsonPatchOperation" }, { "properties": { "path": { "type": "string", "pattern": "^/(?:schemaVersion|name|label|description|sourceRelations|aggregationTimeDimension|entities|dimensions|measures)(?:/[\\s\\S]*)?$" } } } ] } ] }, "MetricPatchOperation": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "monomer://schema/semantic/metric/3" } } }, { "allOf": [ { "$ref": "#/$defs/AgentJsonPatchOperation" }, { "properties": { "path": { "type": "string", "pattern": "^/(?:schemaVersion|name|type|display|label|description|timeGranularity|filters|semanticModelName|measure|numerator|denominator|expression|inputMetrics|inputMetric|window|grainToDate|periodAggregation|entity|calculation|baseMetric|conversionMetric|constantProperties)(?:/[\\s\\S]*)?$" } } } ] } ] }, "DashboardDraftPatchOperation": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "#/$defs/DashboardDraftEditableDocument" } } }, { "allOf": [ { "$ref": "#/$defs/AgentJsonPatchOperation" }, { "properties": { "path": { "type": "string", "pattern": "^/(?:definition|parameterBindings|variables)(?:/[\\s\\S]*)?$" } } } ] } ] }, "DashboardDraftEditableDocument": { "type": "object", "additionalProperties": false, "required": [ "definition", "parameterBindings", "variables" ], "properties": { "definition": { "$ref": "monomer://schema/dashboard/1" }, "parameterBindings": { "$ref": "#/$defs/DashboardValueMap" }, "variables": { "$ref": "#/$defs/DashboardValueMap" } } }, "ConnectorCatalogSelectionPatchOperation": { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "#/$defs/ConnectorCatalogSelectionResourceBody" } } }, "CatalogSelectionPatchOperation": { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "#/$defs/CatalogSelectionResourceBody" } } }, "AgentJsonPatchOperation": { "oneOf": [ { "$ref": "#/$defs/AgentJsonPatchAdd" }, { "$ref": "#/$defs/AgentJsonPatchReplace" }, { "$ref": "#/$defs/AgentJsonPatchRemove" } ] }, "AgentJsonPatchAdd": { "type": "object", "additionalProperties": false, "required": ["op", "path", "value"], "properties": { "op": { "const": "add" }, "path": { "$ref": "#/$defs/JsonPointer" }, "value": {} } }, "AgentJsonPatchReplace": { "type": "object", "additionalProperties": false, "required": ["op", "path", "value"], "properties": { "op": { "const": "replace" }, "path": { "$ref": "#/$defs/JsonPointer" }, "value": {} } }, "AgentJsonPatchRemove": { "type": "object", "additionalProperties": false, "required": ["op", "path"], "properties": { "op": { "const": "remove" }, "path": { "$ref": "#/$defs/JsonPointer" } } }, "JsonPointer": { "type": "string", "pattern": "^(?![\\s\\S]*~(?![01]))(?:/[\\s\\S]*)?$", "maxLength": 2048 }, "AgentInvokeRequest": { "oneOf": [ { "$ref": "#/$defs/SemanticModelCheckInvokeRequest" }, { "$ref": "#/$defs/MetricCheckInvokeRequest" }, { "$ref": "#/$defs/ExploreRunInvokeRequest" }, { "$ref": "#/$defs/ExploreRunCancelInvokeRequest" }, { "$ref": "#/$defs/DashboardDraftStartInvokeRequest" }, { "$ref": "#/$defs/DashboardDraftApplyInvokeRequest" }, { "$ref": "#/$defs/DashboardDraftDiscardInvokeRequest" }, { "$ref": "#/$defs/DashboardQueryRefreshInvokeRequest" }, { "$ref": "#/$defs/DashboardDraftRunCancelInvokeRequest" }, { "$ref": "#/$defs/DashboardSessionOpenInvokeRequest" }, { "$ref": "#/$defs/DashboardSessionRefreshInvokeRequest" }, { "$ref": "#/$defs/CatalogIngestInvokeRequest" }, { "$ref": "#/$defs/CatalogOptionRefreshInvokeRequest" }, { "$ref": "#/$defs/CatalogJobCancelInvokeRequest" }, { "$ref": "#/$defs/DashboardSessionResolveInvokeRequest" }, { "$ref": "#/$defs/ConnectorCredentialRotateInvokeRequest" }, { "$ref": "#/$defs/ConnectorDeleteInvokeRequest" }, { "$ref": "#/$defs/PageDeleteInvokeRequest" }, { "$ref": "#/$defs/PageUploadCompleteInvokeRequest" }, { "$ref": "#/$defs/PageUploadAbortInvokeRequest" }, { "$ref": "#/$defs/OrganizationInvitationResendInvokeRequest" }, { "$ref": "#/$defs/OrganizationInvitationCancelInvokeRequest" }, { "$ref": "#/$defs/WorkspaceMemberAddInvokeRequest" }, { "$ref": "#/$defs/WorkspaceMemberRemoveInvokeRequest" }, { "$ref": "#/$defs/WorkspaceMemberRoleInvokeRequest" }, { "$ref": "#/$defs/PageSessionResolveInvokeRequest" }, { "$ref": "#/$defs/SemanticModelDeleteInvokeRequest" }, { "$ref": "#/$defs/SemanticModelRestoreInvokeRequest" }, { "$ref": "#/$defs/MetricDeleteInvokeRequest" }, { "$ref": "#/$defs/MetricRestoreInvokeRequest" }, { "$ref": "#/$defs/DashboardDeleteInvokeRequest" }, { "$ref": "#/$defs/DashboardRestoreInvokeRequest" } ] }, "CatalogIngestInvokeRequest": { "description": "Invoking this action starts Catalog ingestion for the requested connector or Catalog entry. An active RUNNING or CANCEL_REQUESTED job for the same workspace and entry is returned; after a terminal state, the next invoke creates a fresh job. A lost response followed by a request after the job is terminal may create another ingestion.", "type": "object", "additionalProperties": false, "required": ["path", "action"], "properties": {"path": {"oneOf": [{"$ref": "#/$defs/CatalogRootResourcePath"}, {"$ref": "#/$defs/CatalogEntryResourcePath"}]}, "action": {"const": "ingest"}} }, "CatalogOptionRefreshInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action"], "properties": {"path": {"$ref": "#/$defs/CatalogOptionCollectionPath"}, "action": {"const": "refresh"}} }, "CatalogJobCancelInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action"], "properties": { "path": {"oneOf": [{"$ref": "#/$defs/CatalogOptionRefreshResourcePath"}, {"$ref": "#/$defs/CatalogIngestionResourcePath"}]}, "action": {"const": "cancel"} } }, "ExploreRunInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": { "const": "workspace/explore/runs" }, "action": { "const": "run" }, "input": { "$ref": "#/$defs/ExploreRunRequest" } } }, "ExploreRunRequest": { "oneOf": [ { "$ref": "#/$defs/SqlExploreRun" }, { "$ref": "#/$defs/SemanticExploreRun" } ] }, "ExploreRunCancelInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action"], "properties": { "path": { "$ref": "#/$defs/ExploreRunResourcePath" }, "action": { "const": "cancel" } } }, "SqlExploreRun": { "description": "Native SQL validation is accident prevention; warehouse-account permissions define the data boundary. RAW_SQL_VALIDATION_REJECTED, PERMISSION_DENIED and READ_ONLY_VIOLATION return CONFLICT with retryable=false. SQL rejection uses the Execution safe message; permission denial directs the caller to the Connector warehouse-account permissions. Before acceptance, Execution validation failure codes are preserved as Problem codes with HTTP 503. AUTHENTICATION_FAILED has retryable=false and requires updating Connector credentials; CONNECTION_FAILED and CREDENTIAL_UNAVAILABLE have retryable=true and require checking Connector settings or credentials. RAW_SQL_VALIDATION_DEADLINE_EXCEEDED means validation timed out without identifying the cause and has retryable=true, as do RESOURCE_EXHAUSTED and RAW_SQL_VALIDATION_FAILED. Monomer Execution RPC unavailability returns OWNER_UNAVAILABLE with HTTP 503 and retryable=true.", "type": "object", "additionalProperties": false, "required": ["kind", "connectorId", "sql"], "properties": { "kind": { "const": "SQL_EXPLORE_RUN" }, "connectorId": { "$ref": "#/$defs/Uuid" }, "sql": { "type": "string", "minLength": 1, "maxLength": 1048576 } } }, "SemanticExploreRun": { "type": "object", "additionalProperties": false, "required": ["kind", "connectorId", "query"], "properties": { "kind": { "const": "SEMANTIC_EXPLORE_RUN" }, "connectorId": { "$ref": "#/$defs/Uuid" }, "query": { "$ref": "monomer://schema/semantic/query/4" } } }, "DashboardDraftStartInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": {"$ref": "#/$defs/DashboardDraftResourcePath"}, "action": {"const": "start"}, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "parameterBindings"], "properties": { "kind": { "const": "DASHBOARD_DRAFT_START", "description": "If a shared Draft already exists, returns it unchanged without applying the new parameterBindings. Creates a Draft from the input bindings only when none exists; use edit to change an existing Draft's inputs." }, "parameterBindings": {"$ref": "#/$defs/DashboardValueMap"} } } } }, "DashboardDraftApplyInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "apply" }, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "expectedRevision"], "properties": { "kind": { "const": "DASHBOARD_DRAFT_APPLY" }, "expectedRevision": { "$ref": "#/$defs/RevisionString" } } } } }, "DashboardDraftDiscardInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "discard" }, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "expectedRevision"], "properties": { "kind": { "const": "DASHBOARD_DRAFT_DISCARD", "description": "Resets the shared Draft to the applied Dashboard definition. Unchanged inputs keep their Draft values; the same Explorer role as apply is required." }, "expectedRevision": { "$ref": "#/$defs/RevisionString" } } } } }, "DashboardQueryRefreshInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "refresh" }, "input": { "type": "object", "additionalProperties": false, "required": ["kind", "queryNames"], "properties": { "kind": { "const": "DASHBOARD_QUERY_REFRESH" }, "queryNames": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 256 } } } } } }, "DashboardDraftRunCancelInvokeRequest": { "type": "object", "additionalProperties": false, "required": ["path", "action"], "properties": { "path": { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, "action": { "const": "cancel" } } }, "DashboardSessionOpenInvokeRequest": { "type": "object", "description": "Open a new Viewer Session when you need the Dashboard's current definition with fixed Parameter values. Saves an immutable definition snapshot and complete Parameter bindings, resolves Variable initials, and starts a QueryRun for every named query asynchronously. Does not edit the current definition or shared Draft, wait for results, or create shared readyResults. Returns ACCEPTED with a DASHBOARD_SESSION result.path, without rows or a queryRuns map. READ that Session, then resolve with its initialVariables to get queryRuns; READ each QueryRun path and its advertised result child when SUCCEEDED. runningQueryRuns contains only RUNNING activity, so an empty array does not mean no queries ran. An identical commandId replay returns the stored Session path after current caller admission, without replanning or new execution admission. If Apply changes the current definition while a new open is being planned, returns 409 SESSION_CONFLICT without creating a Session or QueryRuns. Read the current Dashboard and submit a new commandId.", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": {"$ref": "#/$defs/DashboardSessionCollectionPath"}, "action": {"const": "open"}, "input": { "type": "object", "description": "Supply the fixed Parameters for the new Session. Variables are initialized from the saved definition and these bindings; open does not accept a variables map.", "additionalProperties": false, "required": ["kind", "parameterBindings"], "properties": {"kind": {"const": "DASHBOARD_SESSION_OPEN"}, "parameterBindings": {"$ref": "#/$defs/DashboardValueMap", "description": "Complete map from every declared Parameter name to its typed value, including explicit null for nullable Parameters. These values remain immutable for the Session. An empty map is valid only when the current definition declares no Parameters; omitted keys do not receive defaults."}} } } }, "DashboardSessionRefreshInvokeRequest": { "type": "object", "description": "After resolving inputs, request fresh data or retry selected named queries in an existing Session. Unlike resolve, skips matching SUCCEEDED reuse for queryNames, joins matching RUNNING runs, and otherwise starts new QueryRuns only for those names. Unselected queries keep matching SUCCEEDED or RUNNING runs, or matching FAILED or CANCELLED runs if neither exists. Rejects the whole refresh with REFRESH_QUERY_RUN_UNAVAILABLE if any unselected query has no matching run; resolve the inputs first. Does not create a Session, change its immutable snapshot, store caller selections or readyResults, or cancel shared runs. Returns ACCEPTED with the Session result.path, validated variables, and a complete queryRuns map from query name to QueryRun path. READ each path, observe RUNNING until terminal, and READ its advertised result child when SUCCEEDED. An identical commandId replay returns the stored variables and QueryRun paths after current caller admission, without replanning or new execution admission; changed input under the same commandId returns 409 IDEMPOTENCY_CONFLICT.", "additionalProperties": false, "required": ["path", "action", "input"], "properties": { "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "refresh" }, "input": { "type": "object", "description": "Use the complete Variable values for this request and select the named queries whose successful results should be refreshed.", "additionalProperties": false, "required": ["kind", "queryNames", "variables"], "properties": { "kind": { "const": "DASHBOARD_SESSION_REFRESH" }, "queryNames": { "type": "array", "description": "Non-empty unique names from the Session definition's queries map. Only these queries may start new runs during refresh; a matching RUNNING run is shared. Other queries must already have a run matching the supplied inputs and current plan. To refresh a widget, select the queries it uses.", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 256 } }, "variables": { "$ref": "#/$defs/DashboardValueMap", "description": "Complete map from every declared Variable name to its typed value, including explicit null for nullable Variables. Use the values you selected, or the Session READ body's initialVariables for initial inputs. This is not a patch and does not change the Session's Parameters. An empty map is valid only when the Session declares no Variables; it does not apply defaults or retain earlier values." } } } } }, "DashboardResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "ExploreRunResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/explore/runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "DashboardDraftResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/draft$" } ] }, "DashboardDraftStatusResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/draft/status$" } ] }, "DashboardSessionCollectionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions$" } ] }, "DashboardSessionResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "DashboardQueryRunResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/draft/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "DashboardDraftQueryRunCollectionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/draft/query-runs$" } ] }, "DashboardDraftQueryResultResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/draft/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/result$" } ] }, "DashboardSessionQueryRunCollectionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs$" } ] }, "DashboardSessionQueryRunResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "DashboardSessionQueryResultResourcePath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/result$" } ] }, "AgentAvailableOperation": { "description": "Every follow-up operation that applies to the current caller and resource state, from an exact read or a concrete collection list. It is not final authorization or a guarantee of success; each call revalidates input, permission, and state.", "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "const": "workspace/semantic-models" }, { "$ref": "#/$defs/SemanticModelResourcePath" } ] }, "action": { "const": "check" }, "inputKind": { "const": "SEMANTIC_MODEL_CHECK" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "const": "workspace/metrics" }, { "$ref": "#/$defs/MetricResourcePath" } ] }, "action": { "const": "check" }, "inputKind": { "const": "METRIC_CHECK" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path" ], "properties": { "operation": { "const": "LIST" }, "path": { "oneOf": [ { "const": "workspace" }, { "$ref": "#/$defs/WorkspaceInstalledCollectionPath" }, { "$ref": "#/$defs/DashboardSessionCollectionPath" }, { "$ref": "#/$defs/DashboardDraftQueryRunCollectionPath" }, { "$ref": "#/$defs/DashboardSessionQueryRunCollectionPath" }, { "$ref": "#/$defs/CatalogCollectionPath" }, { "$ref": "#/$defs/CatalogOptionCollectionPath" }, { "$ref": "#/$defs/CatalogOptionRefreshCollectionPath" }, { "$ref": "#/$defs/PageVersionCollectionPath" }, { "$ref": "#/$defs/OrganizationCollectionPath" }, { "$ref": "#/$defs/WorkspaceManagementCollectionPath" }, { "$ref": "#/$defs/DashboardOccurrenceCollectionPath" }, { "$ref": "#/$defs/PageSessionCollectionPath" }, { "$ref": "#/$defs/PageRunCollectionPath" }, { "$ref": "#/$defs/SemanticModelHistoryPath" }, { "$ref": "#/$defs/MetricHistoryPath" }, { "$ref": "#/$defs/DashboardHistoryPath" } ] } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path" ], "properties": { "operation": { "const": "READ" }, "path": { "oneOf": [ { "const": "workspace" }, { "$ref": "#/$defs/CatalogRootResourcePath" }, { "$ref": "#/$defs/CatalogEntryResourcePath" }, { "$ref": "#/$defs/CatalogSchemaResourcePath" }, { "$ref": "#/$defs/CatalogRelationResourcePath" }, { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" }, { "$ref": "#/$defs/CatalogSelectionResourcePath" }, { "$ref": "#/$defs/CatalogOptionResourcePath" }, { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" }, { "$ref": "#/$defs/CatalogIngestionResourcePath" }, { "$ref": "#/$defs/CatalogIngestionFailureResourcePath" }, { "$ref": "#/$defs/SemanticModelResourcePath" }, { "$ref": "#/$defs/MetricResourcePath" }, { "$ref": "#/$defs/ExploreRunResourcePath" }, { "$ref": "#/$defs/ExploreResultResourcePath" }, { "$ref": "#/$defs/DashboardResourcePath" }, { "$ref": "#/$defs/DashboardDraftResourcePath" }, { "$ref": "#/$defs/DashboardDraftStatusResourcePath" }, { "$ref": "#/$defs/DashboardSessionResourcePath" }, { "oneOf": [ { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" } ] }, { "oneOf": [ { "$ref": "#/$defs/DashboardDraftQueryResultResourcePath" }, { "$ref": "#/$defs/DashboardSessionQueryResultResourcePath" } ] }, { "$ref": "#/$defs/ConnectorResourcePath" }, { "$ref": "#/$defs/PageResourcePath" }, { "$ref": "#/$defs/PagesTreeResourcePath" }, { "$ref": "#/$defs/PageVersionResourcePath" }, { "$ref": "#/$defs/OrganizationResourcePath" }, { "$ref": "#/$defs/OrganizationMemberPath" }, { "$ref": "#/$defs/OrganizationInvitationPath" }, { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, { "$ref": "#/$defs/WorkspaceMemberCandidatePath" }, { "$ref": "#/$defs/WorkspaceAccessPath" }, { "$ref": "#/$defs/WorkspaceAuthorizationPath" }, { "$ref": "#/$defs/LineageResourcePath" }, { "$ref": "#/$defs/DashboardSchedulesResourcePath" }, { "$ref": "#/$defs/DashboardOccurrenceResourcePath" }, { "$ref": "#/$defs/PageContentResourcePath" }, { "$ref": "#/$defs/PageSessionResourcePath" }, { "$ref": "#/$defs/PageRunResourcePath" }, { "$ref": "#/$defs/PageResultResourcePath" }, { "$ref": "#/$defs/SemanticModelVersionPath" }, { "$ref": "#/$defs/MetricVersionPath" }, { "$ref": "#/$defs/DashboardVersionPath" } ] } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path" ], "properties": { "operation": { "const": "EDIT" }, "path": { "oneOf": [ { "$ref": "#/$defs/SemanticModelResourcePath" }, { "$ref": "#/$defs/MetricResourcePath" }, { "$ref": "#/$defs/DashboardDraftResourcePath" }, { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" }, { "$ref": "#/$defs/CatalogSelectionResourcePath" }, { "$ref": "#/$defs/ConnectorResourcePath" }, { "$ref": "#/$defs/PageResourcePath" }, { "$ref": "#/$defs/PagesTreeResourcePath" } ] } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/semantic-models" }, "inputKind": { "const": "SEMANTIC_MODEL_DEFINITION" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/metrics" }, "inputKind": { "const": "METRIC_DEFINITION" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/dashboards" }, "inputKind": { "const": "DASHBOARD_DEFINITION" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "const": "workspace/explore/runs" }, "action": { "const": "run" }, "inputKind": { "const": "SEMANTIC_EXPLORE_RUN" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "const": "workspace/explore/runs" }, "action": { "const": "run" }, "inputKind": { "const": "SQL_EXPLORE_RUN" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" }, "action": { "const": "cancel" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "start" }, "inputKind": { "const": "DASHBOARD_DRAFT_START", "description": "If a shared Draft already exists, returns it unchanged without applying the new parameterBindings. Creates a Draft from the input bindings only when none exists; use edit to change an existing Draft's inputs." } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "apply" }, "inputKind": { "const": "DASHBOARD_DRAFT_APPLY" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "discard" }, "inputKind": { "const": "DASHBOARD_DRAFT_DISCARD" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "refresh" }, "inputKind": { "const": "DASHBOARD_QUERY_REFRESH" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, "action": { "const": "cancel" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionCollectionPath" }, "action": { "const": "open" }, "inputKind": { "const": "DASHBOARD_SESSION_OPEN" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "refresh" }, "inputKind": { "const": "DASHBOARD_SESSION_REFRESH" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/CatalogRootResourcePath" }, { "$ref": "#/$defs/CatalogEntryResourcePath" } ] }, "action": { "const": "ingest" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/CatalogOptionCollectionPath" }, "action": { "const": "refresh" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" }, { "$ref": "#/$defs/CatalogIngestionResourcePath" } ] }, "action": { "const": "cancel" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "resolve" }, "inputKind": { "const": "DASHBOARD_SESSION_RESOLVE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/connectors" }, "inputKind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "action": { "const": "rotate-credentials" }, "inputKind": { "const": "CONNECTOR_CREDENTIAL_ROTATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/pages" }, "inputKind": { "const": "FOLDER_PAGE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/pages" }, "inputKind": { "const": "DOCUMENT_PAGE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/pages" }, "inputKind": { "const": "DASHBOARD_PAGE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "$ref": "#/$defs/PageVersionCollectionPath" }, "inputKind": { "const": "PAGE_VERSION" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "workspace/page-content-uploads" }, "inputKind": { "const": "PAGE_CONTENT_UPLOAD" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageResourcePath" }, "action": { "const": "delete" }, "inputKind": { "const": "PAGE_DELETE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "action": { "const": "complete" }, "inputKind": { "const": "PAGE_CONTENT_UPLOAD_COMPLETE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "action": { "const": "abort" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "inputKind" ], "properties": { "operation": { "const": "CREATE" }, "path": { "const": "organization/invitations" }, "inputKind": { "const": "ORGANIZATION_INVITATION_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "action": { "const": "resend" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "action": { "const": "cancel" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "const": "workspace/members" }, "action": { "const": "add-member" }, "inputKind": { "const": "WORKSPACE_MEMBER_ADD" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "action": { "const": "remove-member" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "action": { "const": "set-role" }, "inputKind": { "const": "WORKSPACE_MEMBER_ROLE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action", "inputKind" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageSessionResourcePath" }, "action": { "const": "resolve" }, "inputKind": { "const": "DASHBOARD_SESSION_RESOLVE" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/SemanticModelVersionPath" }, "action": { "const": "restore" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/MetricResourcePath" }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/MetricVersionPath" }, "action": { "const": "restore" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardResourcePath" }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "operation", "path", "action" ], "properties": { "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardVersionPath" }, "action": { "const": "restore" } } } ] }, "AgentResourceEnvelope": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "COLLECTION" }, "path": { "const": "workspace" }, "body": { "$ref": "#/$defs/WorkspaceCollectionBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_ROOT" }, "path": { "$ref": "#/$defs/CatalogRootResourcePath" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG" }, "path": { "$ref": "#/$defs/CatalogEntryResourcePath" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "SCHEMA" }, "path": { "$ref": "#/$defs/CatalogSchemaResourcePath" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "RELATION" }, "path": { "$ref": "#/$defs/CatalogRelationResourcePath" }, "body": { "$ref": "#/$defs/CatalogResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CONNECTOR_CATALOG_SELECTION" }, "path": { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" }, "body": { "$ref": "#/$defs/ConnectorCatalogSelectionResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_SELECTION" }, "path": { "$ref": "#/$defs/CatalogSelectionResourcePath" }, "body": { "$ref": "#/$defs/CatalogSelectionResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_SELECTION_OPTION" }, "path": { "$ref": "#/$defs/CatalogOptionResourcePath" }, "body": { "$ref": "#/$defs/CatalogOptionResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_SELECTION_OPTION_REFRESH" }, "path": { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" }, "body": { "$ref": "#/$defs/CatalogOptionRefreshJobResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_INGESTION" }, "path": { "$ref": "#/$defs/CatalogIngestionResourcePath" }, "body": { "$ref": "#/$defs/CatalogIngestionJobResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CATALOG_INGESTION_FAILURE" }, "path": { "$ref": "#/$defs/CatalogIngestionFailureResourcePath" }, "body": { "$ref": "#/$defs/CatalogIngestionFailureResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body", "updatedAt" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "body": { "$ref": "#/$defs/SemanticModelResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } }, "updatedAt": { "type": "string", "format": "date-time" }, "updatedBy": { "$ref": "#/$defs/AgentActor" }, "credentialSurface": { "$ref": "#/$defs/CredentialSurface" }, "agentApp": { "$ref": "#/$defs/AgentApp" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body", "updatedAt", "sourceConnectors" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" }, "body": { "$ref": "#/$defs/MetricResourceBody" }, "sourceConnectors": { "description": "Source-definition candidates shared by every model in the metric dependency closure, including stored metric and input filters. Empty when references are unresolved or no candidate exists. Unlike check.runsOn, this does not validate Catalog, MetricFlow, time spine, or warehouse execution.", "type": "array", "items": { "$ref": "#/$defs/AgentMetricSourceConnector" } }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } }, "updatedAt": { "type": "string", "format": "date-time" }, "updatedBy": { "$ref": "#/$defs/AgentActor" }, "credentialSurface": { "$ref": "#/$defs/CredentialSurface" }, "agentApp": { "$ref": "#/$defs/AgentApp" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "EXPLORE_RUN" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" }, "body": { "$ref": "#/$defs/ExploreRunResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "EXPLORE_RESULT" }, "path": { "$ref": "#/$defs/ExploreResultResourcePath" }, "body": { "$ref": "#/$defs/ExploreResultResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" }, "body": { "$ref": "#/$defs/DashboardResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "revision", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_DRAFT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "revision": { "$ref": "#/$defs/RevisionString" }, "body": { "$ref": "#/$defs/DashboardDraftResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_DRAFT_STATUS" }, "path": { "$ref": "#/$defs/DashboardDraftStatusResourcePath" }, "body": { "$ref": "#/$defs/DashboardDraftStatusResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_SESSION" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "body": { "$ref": "#/$defs/DashboardSessionResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_QUERY_RUN" }, "path": { "oneOf": [ { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" } ] }, "body": { "$ref": "#/$defs/DashboardQueryRunResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_QUERY_RESULT" }, "path": { "oneOf": [ { "$ref": "#/$defs/DashboardDraftQueryResultResourcePath" }, { "$ref": "#/$defs/DashboardSessionQueryResultResourcePath" } ] }, "body": { "$ref": "#/$defs/DashboardQueryResultResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "CONNECTOR" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "body": { "$ref": "#/$defs/ConnectorResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body", "revision" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGE" }, "path": { "$ref": "#/$defs/PageResourcePath" }, "body": { "$ref": "#/$defs/PageResourceBody" }, "availableOperations": { "type": "array", "items": { "$ref": "#/$defs/AgentAvailableOperation" }, "maxItems": 100 }, "revision": { "$ref": "#/$defs/RevisionString" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body", "revision" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGES_TREE" }, "path": { "$ref": "#/$defs/PagesTreeResourcePath" }, "body": { "$ref": "#/$defs/PagesTreeResourceBody" }, "availableOperations": { "type": "array", "items": { "$ref": "#/$defs/AgentAvailableOperation" }, "maxItems": 100 }, "revision": { "$ref": "#/$defs/RevisionString" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGE_VERSION" }, "path": { "$ref": "#/$defs/PageVersionResourcePath" }, "body": { "$ref": "#/$defs/PageVersionResourceBody" }, "availableOperations": { "type": "array", "items": { "$ref": "#/$defs/AgentAvailableOperation" }, "maxItems": 100 } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "ORGANIZATION" }, "path": { "$ref": "#/$defs/OrganizationResourcePath" }, "body": { "$ref": "#/$defs/AgentOrganizationBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "ORGANIZATION_MEMBER" }, "path": { "$ref": "#/$defs/OrganizationMemberPath" }, "body": { "$ref": "#/$defs/AgentOrganizationMemberBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "ORGANIZATION_INVITATION" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "body": { "$ref": "#/$defs/AgentOrganizationInvitationBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "body": { "$ref": "#/$defs/AgentWorkspaceMemberBodyMember" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "$ref": "#/$defs/WorkspaceMemberCandidatePath" }, "body": { "$ref": "#/$defs/AgentWorkspaceMemberBodyCandidate" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "WORKSPACE_ACCESS" }, "path": { "$ref": "#/$defs/WorkspaceAccessPath" }, "body": { "$ref": "#/$defs/AgentWorkspaceAccessBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "WORKSPACE_AUTHORIZATION" }, "path": { "$ref": "#/$defs/WorkspaceAuthorizationPath" }, "body": { "$ref": "#/$defs/AgentWorkspaceAuthorizationBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "LINEAGE_RESOURCE" }, "path": { "$ref": "#/$defs/LineageResourcePath" }, "body": { "$ref": "#/$defs/AgentLineageResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_SCHEDULES" }, "path": { "$ref": "#/$defs/DashboardSchedulesResourcePath" }, "body": { "$ref": "#/$defs/DashboardSchedulesResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_SCHEDULE_OCCURRENCE" }, "path": { "$ref": "#/$defs/DashboardOccurrenceResourcePath" }, "body": { "$ref": "#/$defs/DashboardOccurrenceResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGE_CONTENT" }, "path": { "$ref": "#/$defs/PageContentResourcePath" }, "body": { "$ref": "#/$defs/PageContentResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGE_SESSION" }, "path": { "$ref": "#/$defs/PageSessionResourcePath" }, "body": { "$ref": "#/$defs/PageSessionResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "PAGE_QUERY_RUN" }, "path": { "$ref": "#/$defs/PageRunResourcePath" }, "body": { "$ref": "#/$defs/PageRunResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body", "availableOperations" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_QUERY_RESULT" }, "path": { "$ref": "#/$defs/PageResultResourcePath" }, "body": { "$ref": "#/$defs/DashboardQueryResultResourceBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "SEMANTIC_MODEL_VERSION" }, "path": { "$ref": "#/$defs/SemanticModelVersionPath" }, "body": { "$ref": "#/$defs/SemanticModelVersionBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "METRIC_VERSION" }, "path": { "$ref": "#/$defs/MetricVersionPath" }, "body": { "$ref": "#/$defs/MetricVersionBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "kind", "path", "body" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "kind": { "const": "DASHBOARD_VERSION" }, "path": { "$ref": "#/$defs/DashboardVersionPath" }, "body": { "$ref": "#/$defs/DashboardVersionBody" }, "availableOperations": { "type": "array", "maxItems": 100, "items": { "$ref": "#/$defs/AgentAvailableOperation" } } } } ] }, "AgentResourceBody": { "oneOf": [ { "$ref": "#/$defs/WorkspaceCollectionBody" }, { "$ref": "#/$defs/ConnectorResourceBody" }, { "$ref": "#/$defs/CatalogResourceBody" }, { "$ref": "#/$defs/ConnectorCatalogSelectionResourceBody" }, { "$ref": "#/$defs/CatalogSelectionResourceBody" }, { "$ref": "#/$defs/CatalogOptionResourceBody" }, { "$ref": "#/$defs/CatalogOptionRefreshJobResourceBody" }, { "$ref": "#/$defs/CatalogIngestionJobResourceBody" }, { "$ref": "#/$defs/CatalogIngestionFailureResourceBody" }, { "$ref": "#/$defs/SemanticModelResourceBody" }, { "$ref": "#/$defs/MetricResourceBody" }, { "$ref": "#/$defs/ExploreRunResourceBody" }, { "$ref": "#/$defs/ExploreResultResourceBody" }, { "$ref": "#/$defs/DashboardResourceBody" }, { "$ref": "#/$defs/DashboardDraftResourceBody" }, { "$ref": "#/$defs/DashboardDraftStatusResourceBody" }, { "$ref": "#/$defs/DashboardSessionResourceBody" }, { "$ref": "#/$defs/DashboardQueryRunResourceBody" }, { "$ref": "#/$defs/DashboardQueryResultResourceBody" }, { "$ref": "#/$defs/PageResourceBody" }, { "$ref": "#/$defs/PagesTreeResourceBody" }, { "$ref": "#/$defs/PageVersionResourceBody" }, { "$ref": "#/$defs/PageContentResourceBody" }, { "$ref": "#/$defs/PageSessionResourceBody" }, { "$ref": "#/$defs/PageRunResourceBody" }, { "$ref": "#/$defs/SemanticModelVersionBody" }, { "$ref": "#/$defs/MetricVersionBody" }, { "$ref": "#/$defs/DashboardVersionBody" } ] }, "WorkspaceCollectionBody": { "description": "Workspace root resources and availableOperations include installed collection LIST and current owner-filtered management discovery through workspace/access. Root LIST paginates readable collection paths.", "type": "object", "additionalProperties": false, "properties": {"role": {"$ref": "#/$defs/WorkspaceRole"}, "resources": {"type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/AgentAvailableOperation"}}}, "required": ["role", "resources"] }, "ConnectorResourceBody": { "$ref": "monomer://schema/connector/1#/$defs/ConnectorRead" }, "CatalogResourceBody": { "type": "object", "additionalProperties": false, "required": [ "connectorId", "schemaName", "relationName", "relationKind", "columns", "foreignKeys", "partitionKeys", "clusteringKeys", "requiresPartitionFilter" ], "properties": { "connectorId": { "$ref": "#/$defs/Uuid" }, "catalogName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "schemaName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "relationName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "relationKind": { "type": "string", "minLength": 1, "maxLength": 64 }, "viewDefinition": { "type": "string", "minLength": 1, "maxLength": 1048576 }, "columns": { "type": "array", "maxItems": 10000, "items": { "$ref": "#/$defs/CatalogColumn" } }, "primaryKey": { "$ref": "#/$defs/CatalogPrimaryKey" }, "foreignKeys": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/CatalogForeignKey" } }, "partitionKeys": { "type": "array", "maxItems": 10000, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "clusteringKeys": { "type": "array", "maxItems": 10000, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "requiresPartitionFilter": { "type": [ "boolean", "null" ] } } }, "CatalogColumn": { "type": "object", "additionalProperties": false, "required": ["name", "nativeType", "ordinalPosition", "nullable"], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "nativeType": { "type": "string", "minLength": 1, "maxLength": 512 }, "ordinalPosition": { "type": "integer", "minimum": 0 }, "nullable": { "type": "boolean" }, "defaultValue": { "type": "string", "minLength": 1, "maxLength": 4096 } } }, "CatalogPrimaryKey": { "type": "object", "additionalProperties": false, "required": ["columns"], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "columns": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } } } }, "CatalogForeignKey": { "type": "object", "additionalProperties": false, "required": ["columns", "referencedConnectorId", "referencedSchemaName", "referencedRelationName", "referencedColumns"], "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "columns": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "referencedConnectorId": { "$ref": "#/$defs/Uuid" }, "referencedCatalogName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "referencedSchemaName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "referencedRelationName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "referencedColumns": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } } } }, "ConnectorCatalogSelectionResourceBody": { "type": "object", "additionalProperties": false, "required": ["selectedCatalogNames"], "properties": { "selectedCatalogNames": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } } } }, "CatalogRelationSelection": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "ALL_RELATIONS" } } }, { "type": "object", "additionalProperties": false, "required": ["kind", "relationNames"], "properties": { "kind": { "const": "SELECTED_RELATIONS" }, "relationNames": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } } } } ] }, "CatalogSelectionResourceBody": { "type": "object", "additionalProperties": false, "required": ["selectedSchemas"], "properties": { "selectedSchemas": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["schemaName", "relations"], "properties": { "schemaName": { "type": "string", "minLength": 1, "maxLength": 1024 }, "relations": { "$ref": "#/$defs/CatalogRelationSelection" } } } } } }, "CatalogOptionResourceBody": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": ["optionKind"], "properties": { "optionKind": { "const": "CATALOG" } } }, { "type": "object", "additionalProperties": false, "required": ["optionKind", "available"], "properties": { "optionKind": { "const": "SCHEMA" }, "available": { "type": "boolean" } } }, { "type": "object", "additionalProperties": false, "required": ["optionKind", "available", "relationKind"], "properties": { "optionKind": { "const": "RELATION" }, "available": { "type": "boolean" }, "relationKind": { "type": "string", "minLength": 1, "maxLength": 64 } } } ] }, "CatalogOptionRefreshJobResourceBody": { "type": "object", "additionalProperties": false, "required": ["state", "requestedAt"], "properties": { "state": { "enum": ["RUNNING", "CANCEL_REQUESTED", "COMPLETED", "COMPLETED_WITH_ERRORS", "CANCELLED"] }, "requestedAt": { "type": "string", "format": "date-time" }, "terminalAt": { "type": "string", "format": "date-time" }, "failureCode": { "type": "string", "minLength": 1, "maxLength": 128 }, "message": { "type": "string", "minLength": 1, "maxLength": 4096 } } }, "CatalogIngestionJobResourceBody": { "type": "object", "additionalProperties": false, "required": ["state", "requestedAt", "refreshedRelationCount", "runningTaskCount", "errorCount", "runningTargets", "requestedBy"], "properties": { "state": { "enum": ["RUNNING", "CANCEL_REQUESTED", "COMPLETED", "COMPLETED_WITH_ERRORS", "CANCELLED"] }, "requestedAt": { "type": "string", "format": "date-time" }, "terminalAt": { "type": "string", "format": "date-time" }, "refreshedRelationCount": { "type": "integer", "minimum": 0 }, "runningTaskCount": { "type": "integer", "minimum": 0 }, "errorCount": { "type": "integer", "minimum": 0 }, "runningTargets": { "type": "array", "maxItems": 250, "items": { "$ref": "#/$defs/AgentActionResultReference" } }, "requestedBy": { "type": "object", "additionalProperties": false, "required": ["principalId", "displayName"], "properties": {"principalId": {"type": "string", "minLength": 1}, "displayName": {"type": ["string", "null"]}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"}} } } }, "CatalogIngestionFailureResourceBody": { "type": "object", "additionalProperties": false, "required": ["target", "failureCode", "message"], "properties": { "target": { "$ref": "#/$defs/AgentActionResultReference" }, "failureCode": { "type": "string", "minLength": 1, "maxLength": 128 }, "message": { "type": "string", "minLength": 1, "maxLength": 4096 } } }, "AgentActionResultReference": { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["CONNECTOR", "CATALOG", "SCHEMA", "RELATION"] }, "path": { "$ref": "#/$defs/CanonicalResourcePath" } } }, "SourcePartitionInfo": { "type": "object", "additionalProperties": false, "required": [ "semanticModelName", "connectorId", "relation", "requiresPartitionFilter", "partitionKeys", "dimensions", "timeRangeApplies" ], "properties": { "semanticModelName": { "type": "string", "pattern": "^(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$" }, "connectorId": { "type": "string", "format": "uuid" }, "relation": { "$ref": "https://monomer.cc/schemas/problem-details/v1#/$defs/PartitionRelation" }, "requiresPartitionFilter": { "type": [ "boolean", "null" ] }, "partitionKeys": { "type": "array", "maxItems": 10000, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "dimensions": { "type": "array", "maxItems": 10000, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "timeRangeApplies": { "type": "boolean" } } }, "SemanticModelResourceBody": { "type": "object", "required": [ "schemaVersion", "name", "sourceRelations", "entities", "dimensions", "measures", "sourcePartitionInfo" ], "additionalProperties": false, "properties": { "schemaVersion": { "const": 3 }, "name": { "$ref": "monomer://schema/semantic/model/3#/$defs/elementName" }, "label": { "$ref": "monomer://schema/semantic/model/3#/$defs/optionalText" }, "description": { "$ref": "monomer://schema/semantic/model/3#/$defs/optionalText" }, "sourceRelations": { "type": "array", "minItems": 1, "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/sourceRelation" } }, "aggregationTimeDimension": { "$ref": "monomer://schema/semantic/model/3#/$defs/elementName" }, "entities": { "type": "array", "minItems": 1, "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/entity" }, "contains": { "type": "object", "required": [ "type" ], "properties": { "type": { "const": "primary" } } }, "minContains": 1, "maxContains": 1 }, "dimensions": { "type": "array", "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/dimension" } }, "measures": { "type": "array", "items": { "$ref": "monomer://schema/semantic/model/3#/$defs/measure" } }, "sourcePartitionInfo": { "type": "array", "items": { "$ref": "#/$defs/SourcePartitionInfo" } } } }, "MetricResourceBody": { "type": "object", "allOf": [ { "$ref": "monomer://schema/semantic/metric/3#/$defs/common" }, { "type": "object", "required": [ "sourcePartitionInfo" ], "properties": { "sourcePartitionInfo": { "type": "array", "items": { "$ref": "#/$defs/SourcePartitionInfo" } } } }, { "oneOf": [ { "type": "object", "required": [ "semanticModelName", "measure", "type" ], "properties": { "type": { "const": "simple" }, "semanticModelName": { "$ref": "monomer://schema/semantic/metric/3#/$defs/elementName" }, "measure": { "$ref": "monomer://schema/semantic/metric/3#/$defs/elementName" } } }, { "type": "object", "required": [ "numerator", "denominator", "type" ], "properties": { "type": { "const": "ratio" }, "numerator": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" }, "denominator": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" } } }, { "type": "object", "required": [ "expression", "inputMetrics", "type" ], "properties": { "type": { "const": "derived" }, "expression": { "type": "string", "minLength": 1, "pattern": "^[^\\u0000]*$" }, "inputMetrics": { "type": "array", "minItems": 1, "items": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" } } } }, { "type": "object", "required": [ "inputMetric", "type" ], "properties": { "type": { "const": "cumulative" }, "inputMetric": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" }, "window": { "$ref": "monomer://schema/semantic/metric/3#/$defs/window" }, "grainToDate": { "enum": [ "nanosecond", "microsecond", "millisecond", "second", "minute", "hour", "day", "week", "month", "quarter", "year" ] }, "periodAggregation": { "enum": [ "first", "last", "average" ] } } }, { "type": "object", "required": [ "entity", "calculation", "baseMetric", "conversionMetric", "type" ], "properties": { "type": { "const": "conversion" }, "entity": { "$ref": "monomer://schema/semantic/metric/3#/$defs/elementName" }, "calculation": { "enum": [ "conversions", "conversion_rate" ] }, "baseMetric": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" }, "conversionMetric": { "$ref": "monomer://schema/semantic/metric/3#/$defs/metricInput" }, "window": { "$ref": "monomer://schema/semantic/metric/3#/$defs/window" }, "constantProperties": { "type": "array", "items": { "$ref": "monomer://schema/semantic/metric/3#/$defs/constantProperty" } } } } ] } ], "unevaluatedProperties": false }, "ExploreRunResourceBody": { "description": "Immutable SQL execution history. SQL runs return sql; Semantic runs return sql and the original query. SQL presence does not prove successful connection or execution; inspect state. History is never regenerated from current definitions. Reading an exact Run or its result requires current Explorer or higher membership in the Run Workspace, regardless of the requesting actor. Run listing and cancellation remain limited to the owning actor. History survives definition changes and result retention expiry; result reads still enforce retention.", "oneOf": [ { "type": "object", "additionalProperties": false, "required": ["runKind", "connectorId", "state", "sql", "createdAt", "updatedAt"], "properties": { "runKind": {"const": "SQL"}, "connectorId": {"$ref": "#/$defs/Uuid"}, "state": {"enum": ["RUNNING", "SUCCEEDED"]}, "sql": {"type": "string", "minLength": 1, "maxLength": 2097152}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"} } }, { "type": "object", "additionalProperties": false, "required": ["runKind", "connectorId", "state", "sql", "failureCode", "failureDetail", "createdAt", "updatedAt"], "properties": { "runKind": {"const": "SQL"}, "connectorId": {"$ref": "#/$defs/Uuid"}, "state": {"enum": ["FAILED", "CANCELLED"]}, "sql": {"type": "string", "minLength": 1, "maxLength": 2097152}, "failureCode": {"enum": ["PARTITION_FILTER_REQUIRED", "EXECUTION_FAILED", "PERMISSION_DENIED", "CONNECTION_FAILED", "AUTHENTICATION_FAILED", "EXECUTION_ORPHANED", "CANCELLED_BY_ACTOR"]}, "failureDetail": {"type": "string", "minLength": 1, "maxLength": 4096}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"} } }, { "type": "object", "additionalProperties": false, "required": ["runKind", "connectorId", "state", "sql", "query", "createdAt", "updatedAt"], "properties": { "runKind": {"const": "SEMANTIC"}, "connectorId": {"$ref": "#/$defs/Uuid"}, "state": {"enum": ["RUNNING", "SUCCEEDED"]}, "sql": {"type": "string", "minLength": 1, "maxLength": 2097152}, "query": {"$ref": "monomer://schema/semantic/query/4"}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"} } }, { "type": "object", "additionalProperties": false, "required": ["runKind", "connectorId", "state", "sql", "query", "failureCode", "failureDetail", "createdAt", "updatedAt"], "properties": { "runKind": {"const": "SEMANTIC"}, "connectorId": {"$ref": "#/$defs/Uuid"}, "state": {"enum": ["FAILED", "CANCELLED"]}, "sql": {"type": "string", "minLength": 1, "maxLength": 2097152}, "query": {"$ref": "monomer://schema/semantic/query/4"}, "failureCode": {"enum": ["PARTITION_FILTER_REQUIRED", "EXECUTION_FAILED", "PERMISSION_DENIED", "CONNECTION_FAILED", "AUTHENTICATION_FAILED", "EXECUTION_ORPHANED", "CANCELLED_BY_ACTOR"]}, "failureDetail": {"type": "string", "minLength": 1, "maxLength": 4096}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"} } } ] }, "ExploreResultResourceBody": { "type": "object", "additionalProperties": false, "required": [ "columns", "rows", "totalRowCount", "returnedRowCount", "truncated", "expiresAt", "reportingTimeZone" ], "properties": { "reportingTimeZone": { "description": "The IANA Reporting time zone this run's Semantic SQL was rendered in, such as UTC or Asia/Seoul. Semantic time columns at day or coarser grain are DATE; finer time columns are DATETIME wall-clock values in this zone. Null for SQL runs and for Semantic runs recorded before zones were kept.", "oneOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "columns": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "name", "logicalType", "display" ], "properties": { "name": { "type": "string", "minLength": 1 }, "logicalType": { "description": "Warehouse DATETIME is a timezone-free calendar value serialized as YYYY-MM-DDTHH:mm:ss.ffffff, without Z or offset. TIMESTAMP remains a UTC instant with six fractional digits and Z. DATE remains YYYY-MM-DD. Null values remain JSON null.", "type": "string", "minLength": 1 }, "display": { "oneOf": [ { "$ref": "https://monomer.cc/schemas/metric-display.schema.json" }, { "type": "null" } ] } } } }, "rows": { "type": "array", "items": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" } ] } } }, "totalRowCount": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "returnedRowCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "expiresAt": { "type": "string", "format": "date-time" }, "download": { "$ref": "#/$defs/ExploreResultDownloadLink" } } }, "ExploreResultDownloadLink": { "type": "object", "additionalProperties": false, "required": ["url", "fileName", "mediaType", "byteSize", "expiresAt"], "properties": { "url": { "type": "string", "format": "uri" }, "fileName": { "type": "string", "minLength": 1 }, "mediaType": { "const": "application/vnd.apache.arrow.file" }, "byteSize": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "expiresAt": { "type": "string", "format": "date-time" } } }, "DashboardResourceBody": { "type": "object", "additionalProperties": false, "required": ["definition", "createdAt", "updatedAt"], "properties": { "definition": {"$ref": "monomer://schema/dashboard/1"}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "updatedBy": {"$ref": "#/$defs/AgentActor"}, "credentialSurface": {"$ref": "#/$defs/CredentialSurface"}, "agentApp": {"$ref": "#/$defs/AgentApp"} } }, "DashboardDraftResourceBody": { "description": "Advertises refresh only when definition.queries has at least one query. refresh takes non-empty, unique queryNames.", "type": "object", "additionalProperties": false, "required": ["definition", "parameterBindings", "variables", "targetQueryRuns", "readyResults", "createdAt", "updatedAt"], "properties": { "definition": {"$ref": "monomer://schema/dashboard/1"}, "parameterBindings": {"$ref": "#/$defs/DashboardValueMap"}, "variables": {"$ref": "#/$defs/DashboardValueMap"}, "targetQueryRuns": {"type": "object", "additionalProperties": {"$ref": "#/$defs/DashboardQueryRunResourcePath"}}, "readyResults": {"type": "object", "additionalProperties": {"$ref": "#/$defs/DashboardDraftReadyResult"}}, "createdAt": {"type": "string", "format": "date-time"}, "updatedAt": {"type": "string", "format": "date-time"}, "lastEditedBy": {"$ref": "#/$defs/AgentActor"}, "lastEditedAt": {"type": "string", "format": "date-time"}, "lastEditSurface": {"$ref": "#/$defs/CredentialSurface"}, "lastEditAgentApp": {"$ref": "#/$defs/AgentApp"} } }, "DashboardDraftReadyResult": { "type": "object", "additionalProperties": false, "required": ["authoringRevision", "parameterBindings", "variables", "queryRuns"], "properties": { "authoringRevision": {"$ref": "#/$defs/RevisionString"}, "parameterBindings": {"$ref": "#/$defs/DashboardValueMap"}, "variables": {"$ref": "#/$defs/DashboardValueMap"}, "queryRuns": {"type": "object", "minProperties": 1, "additionalProperties": {"$ref": "#/$defs/DashboardQueryRunResourcePath"}} } }, "DashboardDraftStatusResourceBody": { "description": "A cheap progress check for the shared Draft without its definition or results. Poll it instead of the Draft READ: re-read the Draft when draftRevision changes, and read results for new runs when targetQueryRuns states or readyResults change. Finished runs update targetQueryRuns and readyResults without changing draftRevision.", "type": "object", "additionalProperties": false, "required": ["draftRevision", "targetQueryRuns", "readyResults"], "properties": { "draftRevision": {"$ref": "#/$defs/RevisionString", "description": "Equals the revision of the Draft READ at the same moment. Edits change it; finished runs do not."}, "targetQueryRuns": { "type": "object", "description": "The run that each named Draft query currently targets, keyed by query name, with its current state.", "additionalProperties": { "type": "object", "additionalProperties": false, "required": ["path", "state"], "properties": { "path": {"$ref": "#/$defs/DashboardQueryRunResourcePath"}, "state": {"enum": ["RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"]} } } }, "readyResults": {"type": "object", "description": "The same widget-keyed ready results as the Draft READ body.", "additionalProperties": {"$ref": "#/$defs/DashboardDraftReadyResult"}} } }, "DashboardSessionResourceBody": { "description": "The Session definition and Parameter snapshot, initialVariables, and all RUNNING activity in the Session. resolve is always advertised, and refresh when there are queries. The selected Run map is returned only in the invoke response and is not a saved View.", "type": "object", "additionalProperties": false, "required": ["definition", "parameterBindings", "initialVariables", "runningQueryRuns"], "properties": { "definition": {"$ref": "monomer://schema/dashboard/1"}, "parameterBindings": {"$ref": "#/$defs/DashboardValueMap"}, "initialVariables": { "$ref": "#/$defs/DashboardValueMap" }, "runningQueryRuns": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "queryName", "path", "state" ], "properties": { "queryName": { "type": "string", "minLength": 1, "maxLength": 256 }, "path": { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] } } } } } }, "DashboardQueryRunResourceBody": { "type": "object", "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "queryName", "queryType", "connectorId", "state", "outputColumnNames", "createdAt", "updatedAt" ], "properties": { "queryName": { "type": "string", "minLength": 1, "maxLength": 256 }, "connectorId": { "$ref": "#/$defs/Uuid" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "CANCELLED" ] }, "outputColumnNames": { "description": "Recorded result column keys: Semantic canonical keys for SEMANTIC, declared final Arrow names for SQL. queryType records the execution source and is independent of the current definition.", "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "credentialSurface": { "$ref": "#/$defs/CredentialSurface" }, "agentApp": { "$ref": "#/$defs/AgentApp" }, "queryType": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } }, { "type": "object", "additionalProperties": false, "required": [ "queryName", "queryType", "connectorId", "state", "failureCode", "outputColumnNames", "createdAt", "updatedAt" ], "properties": { "queryName": { "type": "string", "minLength": 1, "maxLength": 256 }, "connectorId": { "$ref": "#/$defs/Uuid" }, "state": { "const": "FAILED" }, "failureCode": { "description": "Stable Dashboard run failure code. Databricks Statement Execution API supports exact TIMESTAMP and canonical NUMBER (wire DECIMAL) binds within the published limits. QUERY_BIND_UNSUPPORTED marks a FAILED run when Monomer rejects any BYTES bind, including typed nulls, before submitting user SQL.", "type": "string", "minLength": 1, "maxLength": 128 }, "failureDetail": { "description": "Safe English failure detail for an Explorer or higher. QUERY_BIND_UNSUPPORTED identifies the rejected bind type and Databricks limitation with a correction hint, without SQL text, Connector details, or bound values.", "type": "string", "minLength": 1, "maxLength": 4096 }, "outputColumnNames": { "description": "Recorded result column keys: Semantic canonical keys for SEMANTIC, declared final Arrow names for SQL. queryType records the execution source and is independent of the current definition.", "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "credentialSurface": { "$ref": "#/$defs/CredentialSurface" }, "agentApp": { "$ref": "#/$defs/AgentApp" }, "queryType": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } } ] }, "DashboardQueryResultResourceBody": { "type": "object", "additionalProperties": false, "required": [ "columns", "queryType", "rows", "totalRowCount", "returnedRowCount", "truncated", "reportingTimeZone" ], "properties": { "reportingTimeZone": { "description": "The IANA Reporting time zone this QueryRun's Semantic SQL was rendered in, such as UTC or Asia/Seoul. Semantic time columns at day or coarser grain are DATE; finer time columns are DATETIME wall-clock values in this zone. Null for SQL runs and for runs recorded before zones were kept.", "oneOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "columns": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "name", "logicalType", "nullable", "display" ], "properties": { "name": { "description": "Semantic canonical result key for SEMANTIC runs, or the declared final Arrow column name for SQL runs.", "type": "string", "minLength": 1 }, "logicalType": { "description": "Warehouse DATETIME is a timezone-free calendar value serialized as YYYY-MM-DDTHH:mm:ss.ffffff, without Z or offset. TIMESTAMP remains a UTC instant with six fractional digits and Z. DATE remains YYYY-MM-DD. Null values remain JSON null.", "type": "string", "minLength": 1, "maxLength": 256 }, "nullable": { "description": "Whether the stored result declares that this column may contain null. Chart and table sources receive the same flag in Monomer.", "type": "boolean" }, "display": { "oneOf": [ { "$ref": "https://monomer.cc/schemas/metric-display.schema.json" }, { "type": "null" } ] } } } }, "rows": { "type": "array", "items": { "type": "array", "items": { "oneOf": [ { "type": "string" }, { "type": "boolean" }, { "type": "null" } ] } } }, "totalRowCount": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "returnedRowCount": { "type": "integer", "minimum": 0 }, "truncated": { "type": "boolean" }, "queryType": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } }, "AgentResourceListingResponse": { "type": "object", "additionalProperties": false, "required": ["requestId", "items"], "properties": { "requestId": {"$ref": "#/$defs/RequestId"}, "items": {"type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/AgentResourceListingItem"}}, "nextCursor": {"type": "string", "maxLength": 6990}, "availableOperations": {"type": "array", "maxItems": 100, "items": {"$ref": "#/$defs/AgentAvailableOperation"}} } }, "AgentResourceListingItem": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "$ref": "#/$defs/WorkspaceInstalledCollectionPath" }, "name": { "type": "string", "minLength": 1, "maxLength": 256 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "name": { "type": "string", "minLength": 1, "maxLength": 256 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name", "sourceConnectors" ], "properties": { "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "sourceConnectors": { "description": "Source-definition candidates shared by every model in the metric dependency closure, including stored metric and input filters. Empty when references are unresolved or no candidate exists. Unlike check.runsOn, this does not validate Catalog, MetricFlow, time spine, or warehouse execution.", "type": "array", "items": { "$ref": "#/$defs/AgentMetricSourceConnector" } } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "CATALOG" }, "path": { "$ref": "#/$defs/CatalogEntryResourcePath" }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "SCHEMA" }, "path": { "$ref": "#/$defs/CatalogSchemaResourcePath" }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "updatedAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name", "relationKind" ], "properties": { "kind": { "const": "RELATION" }, "path": { "$ref": "#/$defs/CatalogRelationResourcePath" }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "relationKind": { "type": "string", "minLength": 1, "maxLength": 64 }, "updatedAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION" }, "path": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/catalog-selection/options/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+$" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name", "optionKind", "available" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION" }, "path": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/options/schemas/[^/\\u0000-\\u001F\\u007F-\\u009F]+$" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "optionKind": { "const": "SCHEMA" }, "available": { "type": "boolean" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name", "optionKind", "available", "relationKind" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION" }, "path": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/options/schemas/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations/[^/\\u0000-\\u001F\\u007F-\\u009F]+$" } ] }, "name": { "type": "string", "minLength": 1, "maxLength": 1024 }, "optionKind": { "const": "RELATION" }, "available": { "type": "boolean" }, "relationKind": { "type": "string", "minLength": 1, "maxLength": 64 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "state", "requestedAt" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION_REFRESH" }, "path": { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" }, "state": { "enum": [ "RUNNING", "CANCEL_REQUESTED", "COMPLETED", "COMPLETED_WITH_ERRORS", "CANCELLED" ] }, "requestedAt": { "type": "string", "format": "date-time" }, "terminalAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "state", "requestedAt" ], "properties": { "kind": { "const": "CATALOG_INGESTION" }, "path": { "$ref": "#/$defs/CatalogIngestionResourcePath" }, "state": { "enum": [ "RUNNING", "CANCEL_REQUESTED", "COMPLETED", "COMPLETED_WITH_ERRORS", "CANCELLED" ] }, "requestedAt": { "type": "string", "format": "date-time" }, "terminalAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_INGESTION_FAILURE" }, "path": { "$ref": "#/$defs/CatalogIngestionFailureResourcePath" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "runKind", "connectorId", "state", "createdAt", "updatedAt" ], "properties": { "kind": { "const": "EXPLORE_RUN" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" }, "runKind": { "enum": [ "SQL", "SEMANTIC" ] }, "connectorId": { "$ref": "#/$defs/Uuid" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "title", "updatedAt" ], "properties": { "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" }, "title": { "type": "string", "minLength": 1, "maxLength": 512 }, "updatedAt": { "type": "string", "format": "date-time" }, "description": { "type": "string", "minLength": 1, "maxLength": 4096 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "queryName", "connectorId", "state", "createdAt", "updatedAt", "queryType" ], "properties": { "kind": { "const": "DASHBOARD_QUERY_RUN" }, "path": { "oneOf": [ { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" } ] }, "queryName": { "type": "string", "minLength": 1, "maxLength": 256 }, "connectorId": { "$ref": "#/$defs/Uuid" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "queryType": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "parameterBindings", "runningQueryRuns", "createdAt", "updatedAt", "lastQueryRunAt" ], "properties": { "kind": { "const": "DASHBOARD_SESSION" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "lastQueryRunAt": { "type": [ "string", "null" ], "format": "date-time" }, "parameterBindings": { "$ref": "#/$defs/DashboardValueMap" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "runningQueryRuns": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "queryName", "path", "state" ], "properties": { "queryName": { "type": "string", "minLength": 1, "maxLength": 256 }, "path": { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "connectorType", "displayName" ], "properties": { "kind": { "const": "CONNECTOR" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "connectorType": { "enum": [ "POSTGRESQL", "BIGQUERY", "SNOWFLAKE", "DATABRICKS", "REDSHIFT", "TRINO", "DUCKDB" ] }, "displayName": { "type": "string", "minLength": 1, "maxLength": 512 } } }, { "$ref": "#/$defs/PageListingItem" }, { "$ref": "#/$defs/PageVersionListingItem" }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "userId", "displayName", "role" ], "properties": { "kind": { "const": "ORGANIZATION_MEMBER" }, "path": { "$ref": "#/$defs/OrganizationMemberPath" }, "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "role": { "$ref": "#/$defs/AgentOrganizationRole" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "id", "email", "status" ], "properties": { "kind": { "const": "ORGANIZATION_INVITATION" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "email": { "type": "string" }, "status": { "$ref": "#/$defs/AgentInvitationStatus" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "userId", "displayName", "role" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "$ref": "#/$defs/WorkspaceMemberPath" }, "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "userId", "displayName" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "$ref": "#/$defs/WorkspaceMemberCandidatePath" }, "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "ref", "label", "address" ], "properties": { "kind": { "const": "LINEAGE_RESOURCE" }, "path": { "$ref": "#/$defs/LineageResourcePath" }, "ref": { "$ref": "#/$defs/AgentManagementResource" }, "label": { "type": "string" }, "address": { "type": "string" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "name" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "oneOf": [ { "$ref": "#/$defs/OrganizationCollectionPath" }, { "$ref": "#/$defs/WorkspaceManagementCollectionPath" } ] }, "name": { "type": "string" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "body" ], "properties": { "kind": { "const": "DASHBOARD_SCHEDULE_OCCURRENCE" }, "path": { "$ref": "#/$defs/DashboardOccurrenceResourcePath" }, "body": { "$ref": "#/$defs/DashboardOccurrenceSummary" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "createdAt", "updatedAt" ], "properties": { "kind": { "const": "PAGE_SESSION" }, "path": { "$ref": "#/$defs/PageSessionResourcePath" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "body" ], "properties": { "kind": { "const": "PAGE_QUERY_RUN" }, "path": { "$ref": "#/$defs/PageRunResourcePath" }, "body": { "$ref": "#/$defs/PageRunResourceBody" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "userId", "displayName", "email", "role" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" }, "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "email": { "type": "string" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } }, { "$ref": "#/$defs/SemanticModelVersionListingItem" }, { "$ref": "#/$defs/MetricVersionListingItem" }, { "$ref": "#/$defs/DashboardVersionListingItem" } ] }, "AgentActionResult": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "check" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "const": "workspace/semantic-models" }, { "$ref": "#/$defs/SemanticModelResourcePath" } ] }, "action": { "const": "check" }, "status": { "const": "COMPLETED" }, "result": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/semantic-models" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" } } } ] }, "check": { "$ref": "#/$defs/SemanticCheckResult" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "check" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "const": "workspace/metrics" }, { "$ref": "#/$defs/MetricResourcePath" } ] }, "action": { "const": "check" }, "status": { "const": "COMPLETED" }, "result": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/metrics" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" } } } ] }, "check": { "$ref": "#/$defs/SemanticCheckResult" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/semantic-models" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/metrics" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "webUrl" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/dashboards" }, "status": { "const": "COMPLETED" }, "webUrl": { "type": "string", "format": "uri", "pattern": "^https?://", "description": "Absolute URL on the configured Web origin. Opens the shared Draft for create/edit and the Dashboard Viewer after apply. Requires normal browser authentication and authorization." }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/MetricResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "webUrl" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "status": { "const": "COMPLETED" }, "webUrl": { "type": "string", "format": "uri", "pattern": "^https?://", "description": "Absolute URL on the configured Web origin. Opens the shared Draft for create/edit and the Dashboard Viewer after apply. Requires normal browser authentication and authorization." }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_DRAFT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CONNECTOR_CATALOG_SELECTION" }, "path": { "$ref": "#/$defs/ConnectorCatalogSelectionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/CatalogSelectionResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_SELECTION" }, "path": { "$ref": "#/$defs/CatalogSelectionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "const": "workspace/explore/runs" }, "action": { "const": "run" }, "status": { "enum": [ "ACCEPTED", "COMPLETED" ] }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "EXPLORE_RUN" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" }, "action": { "const": "cancel" }, "status": { "enum": [ "ACCEPTED", "COMPLETED" ] }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "EXPLORE_RUN" }, "path": { "$ref": "#/$defs/ExploreRunResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "start" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_DRAFT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "webUrl" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "apply" }, "status": { "const": "COMPLETED" }, "webUrl": { "type": "string", "format": "uri", "pattern": "^https?://", "description": "Absolute URL on the configured Web origin. Opens the shared Draft for create/edit and the Dashboard Viewer after apply. Requires normal browser authentication and authorization." }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "discard" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_DRAFT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" }, "action": { "const": "refresh" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_DRAFT" }, "path": { "$ref": "#/$defs/DashboardDraftResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardQueryRunResourcePath" }, "action": { "const": "cancel" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_QUERY_RUN" }, "path": { "$ref": "#/$defs/DashboardQueryRunResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionCollectionPath" }, "action": { "const": "open" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_SESSION" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "variables", "queryRuns" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "refresh" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_SESSION" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" } } }, "variables": { "$ref": "#/$defs/DashboardValueMap" }, "queryRuns": { "type": "object", "additionalProperties": { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" } } } }, { "type": "object", "description": "The accepted path is the active or newly created ingestion. A lost response followed by a request after the job is terminal may create another ingestion; use the returned path to observe or cancel the job.", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/CatalogRootResourcePath" }, { "$ref": "#/$defs/CatalogEntryResourcePath" } ] }, "action": { "const": "ingest" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_INGESTION" }, "path": { "$ref": "#/$defs/CatalogIngestionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/CatalogOptionCollectionPath" }, "action": { "const": "refresh" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION_REFRESH" }, "path": { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" }, "action": { "const": "cancel" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_SELECTION_OPTION_REFRESH" }, "path": { "$ref": "#/$defs/CatalogOptionRefreshResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/CatalogIngestionResourcePath" }, "action": { "const": "cancel" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CATALOG_INGESTION" }, "path": { "$ref": "#/$defs/CatalogIngestionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "variables", "queryRuns" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "resolve" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD_SESSION" }, "path": { "$ref": "#/$defs/DashboardSessionResourcePath" } } }, "variables": { "$ref": "#/$defs/DashboardValueMap" }, "queryRuns": { "type": "object", "additionalProperties": { "$ref": "#/$defs/DashboardSessionQueryRunResourcePath" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/connectors" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CONNECTOR" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CONNECTOR" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "CONNECTOR" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" } } }, "action": { "const": "rotate-credentials" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/connectors" } } }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/pages" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE" }, "path": { "$ref": "#/$defs/PageResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "$ref": "#/$defs/PageVersionCollectionPath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE_VERSION" }, "path": { "$ref": "#/$defs/PageVersionResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/PageResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE" }, "path": { "$ref": "#/$defs/PageResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "EDIT" }, "path": { "$ref": "#/$defs/PagesTreeResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGES_TREE" }, "path": { "$ref": "#/$defs/PagesTreeResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGES_TREE" }, "path": { "$ref": "#/$defs/PagesTreeResourcePath" } } }, "action": { "const": "delete" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGES_TREE" }, "path": { "$ref": "#/$defs/PagesTreeResourcePath" } } }, "action": { "const": "abort" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "upload", "partSizeBytes", "parts" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "workspace/page-content-uploads" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE_CONTENT_UPLOAD" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" } } }, "upload": { "$ref": "#/$defs/PageUploadMetadata" }, "partSizeBytes": { "$ref": "#/$defs/PageContentSize" }, "parts": { "type": "array", "items": { "$ref": "#/$defs/PageUploadPart" }, "minItems": 1, "maxItems": 10000 } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "upload", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE_CONTENT_UPLOAD" }, "path": { "$ref": "#/$defs/PageUploadResourcePath" } } }, "upload": { "$ref": "#/$defs/PageUploadMetadata" }, "action": { "const": "complete" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "CREATE" }, "path": { "const": "organization/invitations" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "ORGANIZATION_INVITATION" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "ORGANIZATION_INVITATION" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" } } }, "action": { "const": "resend" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "organization/invitations" } } }, "action": { "const": "cancel" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "const": "workspace/members" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "$ref": "#/$defs/WorkspaceMemberPath" } } }, "action": { "const": "add-member" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/WorkspaceMemberPath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/members" } } }, "action": { "const": "remove-member" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "status", "result", "action" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "$ref": "#/$defs/OrganizationCollectionPath" } } }, "action": { "const": "remove-member" } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result", "variables", "queryRuns" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/PageSessionResourcePath" }, "action": { "const": "resolve" }, "status": { "const": "ACCEPTED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE_SESSION" }, "path": { "$ref": "#/$defs/PageSessionResourcePath" } } }, "variables": { "$ref": "#/$defs/DashboardValueMap" }, "queryRuns": { "type": "object", "additionalProperties": { "$ref": "#/$defs/PageRunResourcePath" } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "action": { "const": "set-role" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER" }, "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "action": { "const": "delete" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/semantic-models" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/SemanticModelVersionPath" }, "action": { "const": "restore" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "SEMANTIC_MODEL" }, "path": { "$ref": "#/$defs/SemanticModelResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/MetricResourcePath" }, "action": { "const": "delete" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/metrics" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/MetricVersionPath" }, "action": { "const": "restore" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "METRIC" }, "path": { "$ref": "#/$defs/MetricResourcePath" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardResourcePath" }, "action": { "const": "delete" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "COLLECTION" }, "path": { "const": "workspace/dashboards" } } } } }, { "type": "object", "additionalProperties": false, "required": [ "requestId", "operation", "path", "action", "status", "result" ], "properties": { "requestId": { "$ref": "#/$defs/RequestId" }, "operation": { "const": "INVOKE" }, "path": { "$ref": "#/$defs/DashboardVersionPath" }, "action": { "const": "restore" }, "status": { "const": "COMPLETED" }, "result": { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" } } } } } ] }, "SemanticModelResourcePath": {"allOf": [{"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/semantic-models/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$"}]}, "MetricResourcePath": {"allOf": [{"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/metrics/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$"}]}, "ExploreResultResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/explore/runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/result$"} ] }, "CatalogRootResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog$"} ] }, "CatalogEntryResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+$"} ] }, "CatalogSchemaResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog(?:/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+)?/schemas/[^/\\u0000-\\u001F\\u007F-\\u009F]+$"} ] }, "CatalogRelationResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog(?:/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+)?/schemas/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations/[^/\\u0000-\\u001F\\u007F-\\u009F]+$" } ] }, "ConnectorCatalogSelectionResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/catalog-selection$"} ] }, "CatalogSelectionResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, {"type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog(?:/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+)?/selection$"} ] }, "CatalogOptionCollectionPath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalog-selection/options/catalogs|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/options/schemas(?:/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations)?)$" } ] }, "CatalogOptionResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalog-selection/options/catalogs|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/options/schemas(?:/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations)?)/[^/\\u0000-\\u001F\\u007F-\\u009F]+$" } ] }, "CatalogOptionRefreshCollectionPath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalog-selection/option-refreshes/catalogs|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/option-refreshes/schemas(?:/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations)?)$" } ] }, "CatalogOptionRefreshResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalog-selection/option-refreshes/catalogs|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?selection/option-refreshes/schemas(?:/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations)?)/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "CatalogIngestionResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog(?:/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+)?/ingestions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "CatalogIngestionFailureResourcePath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog(?:/catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+)?/ingestions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/failures/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "CatalogCollectionPath": { "allOf": [ {"$ref": "#/$defs/CanonicalResourcePath"}, { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/catalog/(?:catalogs|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?schemas(?:/[^/\\u0000-\\u001F\\u007F-\\u009F]+/relations)?|(?:catalogs/[^/\\u0000-\\u001F\\u007F-\\u009F]+/)?ingestions(?:/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/failures)?)$" } ] }, "WorkspaceInstalledCollectionPath": {"enum": [ "workspace/connectors", "workspace/dashboards", "workspace/explore/runs", "workspace/metrics", "workspace/semantic-models", "workspace/pages" ]}, "DashboardValue": { "oneOf": [ {"type": "null"}, {"type": "string"}, {"type": "boolean"}, {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string"}}, {"type": "object", "additionalProperties": false, "required": ["start", "end"], "properties": {"start": {"type": "string"}, "end": {"type": "string"}}} ] }, "DashboardValueMap": {"type": "object", "propertyNames": {"$ref": "monomer://schema/dashboard/1#/$defs/name"}, "additionalProperties": {"$ref": "#/$defs/DashboardValue"}}, "DashboardSessionResolveInvokeRequest": { "type": "object", "description": "Select QueryRuns for every named query in an existing Session when first reading results or changing interactive Variable values. Validates the complete variables map and resolves each query's current plan. Within this Session, reuses the latest matching SUCCEEDED run first, otherwise joins a matching RUNNING run, otherwise starts a new QueryRun; FAILED and CANCELLED runs are not reused. Unlike refresh, resolve can reuse successful results. Does not create a Session, change its immutable definition or Parameters, store caller selections or readyResults, or cancel shared runs. Returns ACCEPTED with the Session result.path, validated variables, and a complete queryRuns map from query name to QueryRun path. READ each path, observe RUNNING until terminal, and READ its advertised result child when SUCCEEDED. queryRuns is empty when no queries are declared. An identical commandId replay returns the stored variables and QueryRun paths after current caller admission, without replanning or new execution admission; changed input under the same commandId returns 409 IDEMPOTENCY_CONFLICT.", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "$ref": "#/$defs/DashboardSessionResourcePath" }, "action": { "const": "resolve" }, "input": { "type": "object", "description": "Supply your complete Variable values for this result selection. For initial results, copy initialVariables from the Session READ body.", "additionalProperties": false, "required": [ "kind", "variables" ], "properties": { "kind": { "const": "DASHBOARD_SESSION_RESOLVE" }, "variables": { "$ref": "#/$defs/DashboardValueMap", "description": "Complete map from every declared Variable name to its typed value, including explicit null for nullable Variables. Use the values you selected, or the Session READ body's initialVariables for initial inputs. This is not a patch and does not change the Session's Parameters. An empty map is valid only when the Session declares no Variables; it does not apply defaults or retain earlier values." } } } } }, "ConnectorResourcePath": { "type": "string", "pattern": "^workspace/connectors/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "ConnectorCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "workspace/connectors" }, "input": { "$ref": "#/$defs/ConnectorCreateInput" } } }, "ConnectorCreateInput": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/PostgresqlCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/PostgresqlCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/PostgresqlCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/PostgresqlCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/BigqueryCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/BigqueryCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/BigqueryCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/BigqueryCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/SnowflakeCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/SnowflakeCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/SnowflakeCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/SnowflakeCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/TrinoCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/TrinoCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/TrinoCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/TrinoCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/RedshiftCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/RedshiftCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/RedshiftCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/RedshiftCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "connectorType", "displayName", "properties", "credential" ], "properties": { "connectorType": { "$ref": "monomer://schema/connector/1#/$defs/DatabricksCreate/properties/connectorType" }, "displayName": { "$ref": "monomer://schema/connector/1#/$defs/DatabricksCreate/properties/displayName" }, "properties": { "$ref": "monomer://schema/connector/1#/$defs/DatabricksCreate/properties/properties" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/DatabricksCreate/properties/credential" }, "kind": { "const": "CONNECTOR_CREATE" } } } ] }, "ConnectorEditRequest": { "examples": [ { "path": "workspace/connectors/01942b04-6e00-7000-8000-000000000001", "patch": [ { "op": "replace", "path": "/displayName", "value": "Warehouse" } ] } ], "type": "object", "additionalProperties": false, "required": [ "path", "patch" ], "properties": { "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "patch": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "$ref": "#/$defs/ConnectorSettingsPatchOperation" } } } }, "ConnectorSettingsPatchOperation": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "" }, "value": { "$ref": "monomer://schema/connector/1#/$defs/ConnectorSettings" } } }, { "allOf": [ { "$ref": "#/$defs/AgentJsonPatchOperation" }, { "properties": { "path": { "type": "string", "pattern": "^/(?:displayName|properties)(?:/[\\s\\S]*)?$" } } } ] } ] }, "SemanticModelCheckInvokeRequest": { "description": "Checks one unsaved definition like the query path would: the draft replaces the saved definition at an exact path, or is treated as new on the collection path. Nothing is saved and no warehouse is contacted. Requires Explorer or above.", "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "oneOf": [ { "const": "workspace/semantic-models" }, { "$ref": "#/$defs/SemanticModelResourcePath" } ] }, "action": { "const": "check" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "definition" ], "properties": { "kind": { "const": "SEMANTIC_MODEL_CHECK" }, "definition": { "$ref": "monomer://schema/semantic/model/3" } } } } }, "MetricCheckInvokeRequest": { "description": "Checks one unsaved definition like the query path would: the draft replaces the saved definition at an exact path, or is treated as new on the collection path. Nothing is saved and no warehouse is contacted. Requires Explorer or above.", "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "oneOf": [ { "const": "workspace/metrics" }, { "$ref": "#/$defs/MetricResourcePath" } ] }, "action": { "const": "check" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "definition" ], "properties": { "kind": { "const": "METRIC_CHECK" }, "connectorId": { "description": "Check on this Connector only; omit to check every Connector all of its models have a source table on.", "$ref": "#/$defs/Uuid" }, "definition": { "$ref": "monomer://schema/semantic/metric/3" } } } } }, "SemanticCheckResult": { "description": "Same shape as the human POST /semantic/check response. Problems are data; ok is true only when the draft resolves on at least one Connector without problems. Unlike sourceConnectors, runsOn validates current Catalog and MetricFlow and, for Metrics, representative query rendering; it does not execute a warehouse query.", "type": "object", "additionalProperties": false, "required": [ "ok", "runsOn", "preview", "problems", "partitionFilters" ], "properties": { "ok": { "type": "boolean" }, "runsOn": { "type": "array", "items": { "$ref": "#/$defs/Uuid" } }, "preview": { "oneOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "connectorId", "dialect", "sql", "groupBys" ], "properties": { "connectorId": { "$ref": "#/$defs/Uuid" }, "dialect": { "enum": [ "POSTGRESQL", "BIGQUERY", "SNOWFLAKE", "DATABRICKS", "REDSHIFT", "TRINO", "DUCKDB" ] }, "sql": { "type": "string", "minLength": 1 }, "groupBys": { "type": "array", "items": { "oneOf": [ { "$ref": "monomer://schema/semantic/query/4#/$defs/dimensionGroupBy" }, { "$ref": "monomer://schema/semantic/query/4#/$defs/entityGroupBy" }, { "$ref": "monomer://schema/semantic/query/4#/$defs/metricTimeGroupBy" } ] } } } } ] }, "problems": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "code", "field", "connectorId", "definition", "message" ], "properties": { "code": { "enum": [ "NAME_CONFLICT", "NAME_IMMUTABLE", "CONNECTOR_NOT_FOUND", "METRIC_MODEL_NOT_FOUND", "METRIC_DEPENDENCY_NOT_FOUND", "SOURCE_RELATION_NOT_FOUND", "CATALOG_RELATION_NOT_FOUND", "METRICFLOW_MANIFEST_INVALID", "QUERY_UNRENDERABLE", "TIME_SPINE_UNAVAILABLE", "RELATIONSHIP_JOIN_UNSUPPORTED", "UNSUPPORTED_DIALECT", "PARTITION_COLUMN_NOT_MODELED", "TIME_KIND_UNDECLARED", "TIME_KIND_MISMATCH", "TIME_SPINE_COLUMN_TYPE_INVALID" ] }, "field": { "type": [ "string", "null" ] }, "connectorId": { "oneOf": [ { "type": "null" }, { "$ref": "#/$defs/Uuid" } ] }, "definition": { "description": "Another saved definition the problem is about; null when it concerns the draft itself or no single definition.", "oneOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "kind", "name" ], "properties": { "kind": { "enum": [ "SEMANTIC_MODEL", "METRIC" ] }, "name": { "type": "string", "minLength": 1 } } } ] }, "message": { "type": "string", "minLength": 1, "maxLength": 512 } } } }, "partitionFilters": { "type": "array", "items": { "$ref": "https://monomer.cc/schemas/problem-details/v1#/$defs/PartitionFilter" } } } }, "ConnectorCredentialRotateInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "action": { "const": "rotate-credentials" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "credential" ], "properties": { "kind": { "const": "CONNECTOR_CREDENTIAL_ROTATE" }, "credential": { "$ref": "monomer://schema/connector/1#/$defs/ConnectorCredential" } } } } }, "ConnectorDeleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/ConnectorResourcePath" }, "action": { "const": "delete" } } }, "PageResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "PageVersionCollectionPath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/versions$" }, "PageVersionResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/versions/(?:[1-9][0-9]{0,8}|1[0-9]{9}|20[0-9]{8}|21[0-3][0-9]{7}|214[0-6][0-9]{6}|2147[0-3][0-9]{5}|21474[0-7][0-9]{4}|214748[0-2][0-9]{3}|2147483[0-5][0-9]{2}|21474836[0-3][0-9]|214748364[0-7])$" }, "PageUploadResourcePath": { "type": "string", "pattern": "^workspace/page-content-uploads/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "PagesTreeResourcePath": { "const": "workspace/pages/tree" }, "PageCommandId": { "description": "Client-chosen idempotency key for a Pages command. Reuse it only to retry the same command with the same target and request content, including its revision, to replay the recorded result. Use a new commandId when changing the command; reusing it with different content is rejected.", "type": "string", "minLength": 1, "maxLength": 200, "pattern": "\\S" }, "PageTitle": { "type": "string", "minLength": 1, "maxLength": 500, "pattern": "\\S" }, "PageDescription": { "anyOf": [ { "type": "string", "maxLength": 1000 }, { "type": "null" } ] }, "PageContentFormat": { "enum": [ "MARKDOWN", "NOTEBOOK", "HTML" ] }, "PageContentSize": { "type": "integer", "minimum": 1, "maximum": 20971520 }, "PageContentHash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "FolderPageCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "workspace/pages" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "title", "baseRevision", "commandId" ], "properties": { "kind": { "const": "FOLDER_PAGE" }, "title": { "$ref": "#/$defs/PageTitle" }, "description": { "$ref": "#/$defs/PageDescription" }, "parentPageId": { "anyOf": [ { "$ref": "#/$defs/UuidV7" }, { "type": "null" } ] }, "index": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 2147483647 }, { "type": "null" } ] }, "baseRevision": { "$ref": "#/$defs/RevisionString", "description": "Pages tree revision, not an individual Page or content version revision. Read the revision field from READ workspace/pages/tree before constructing this command." }, "commandId": { "$ref": "#/$defs/PageCommandId" } } } } }, "DocumentPageCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "workspace/pages" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "title", "baseRevision", "commandId", "uploadRef" ], "properties": { "kind": { "const": "DOCUMENT_PAGE" }, "title": { "$ref": "#/$defs/PageTitle" }, "description": { "$ref": "#/$defs/PageDescription" }, "parentPageId": { "anyOf": [ { "$ref": "#/$defs/UuidV7" }, { "type": "null" } ] }, "index": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 2147483647 }, { "type": "null" } ] }, "baseRevision": { "$ref": "#/$defs/RevisionString", "description": "Pages tree revision, not an individual Page or content version revision. Read the revision field from READ workspace/pages/tree before constructing this command." }, "commandId": { "$ref": "#/$defs/PageCommandId" }, "uploadRef": { "$ref": "#/$defs/UuidV7" } } } } }, "DashboardPageCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "workspace/pages" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "title", "baseRevision", "commandId", "dashboardId" ], "properties": { "kind": { "const": "DASHBOARD_PAGE" }, "title": { "$ref": "#/$defs/PageTitle" }, "description": { "$ref": "#/$defs/PageDescription" }, "parentPageId": { "anyOf": [ { "$ref": "#/$defs/UuidV7" }, { "type": "null" } ] }, "index": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 2147483647 }, { "type": "null" } ] }, "baseRevision": { "$ref": "#/$defs/RevisionString", "description": "Pages tree revision, not an individual Page or content version revision. Read the revision field from READ workspace/pages/tree before constructing this command." }, "commandId": { "$ref": "#/$defs/PageCommandId" }, "dashboardId": { "$ref": "#/$defs/UuidV7" } } } } }, "PageVersionCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "$ref": "#/$defs/PageVersionCollectionPath" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "commandId", "uploadRef" ], "properties": { "kind": { "const": "PAGE_VERSION" }, "commandId": { "$ref": "#/$defs/PageCommandId" }, "uploadRef": { "$ref": "#/$defs/UuidV7" } } } } }, "PageUploadCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "workspace/page-content-uploads" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "format", "byteSize", "sha256" ], "properties": { "kind": { "const": "PAGE_CONTENT_UPLOAD" }, "format": { "$ref": "#/$defs/PageContentFormat" }, "byteSize": { "$ref": "#/$defs/PageContentSize" }, "sha256": { "$ref": "#/$defs/PageContentHash" } } } } }, "PageMetadataEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "revision", "commandId", "patch" ], "properties": { "path": { "$ref": "#/$defs/PageResourcePath" }, "revision": { "$ref": "#/$defs/RevisionString" }, "commandId": { "$ref": "#/$defs/PageCommandId" }, "patch": { "type": "array", "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "/title" }, "value": { "$ref": "#/$defs/PageTitle" } } }, { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "/description" }, "value": { "$ref": "#/$defs/PageDescription" } } } ] }, "minItems": 2, "maxItems": 2, "allOf": [ { "contains": { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "/title" }, "value": { "$ref": "#/$defs/PageTitle" } } }, "minContains": 1, "maxContains": 1 }, { "contains": { "type": "object", "additionalProperties": false, "required": [ "op", "path", "value" ], "properties": { "op": { "const": "replace" }, "path": { "const": "/description" }, "value": { "$ref": "#/$defs/PageDescription" } } }, "minContains": 1, "maxContains": 1 } ] } }, "examples": [ { "path": "workspace/pages/0198ef28-2000-7000-8000-000000000001", "revision": "0", "commandId": "rename-page", "patch": [ { "op": "replace", "path": "/title", "value": "Weekly revenue" }, { "op": "replace", "path": "/description", "value": null } ] } ] }, "PagesTreeEditRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "revision", "commandId", "patch" ], "properties": { "path": { "$ref": "#/$defs/PagesTreeResourcePath" }, "revision": { "$ref": "#/$defs/RevisionString" }, "commandId": { "$ref": "#/$defs/PageCommandId" }, "patch": { "type": "array", "items": { "allOf": [ { "$ref": "#/$defs/AgentJsonPatchOperation" }, { "properties": { "path": { "type": "string", "pattern": "^/placements(?:/.*)?$" } } } ] }, "minItems": 1, "maxItems": 100 } }, "examples": [ { "path": "workspace/pages/tree", "revision": "0", "commandId": "reorder-pages", "patch": [ { "op": "replace", "path": "/placements", "value": [] } ] } ] }, "PageDeleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "$ref": "#/$defs/PageResourcePath" }, "action": { "const": "delete" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "baseRevision", "commandId" ], "properties": { "kind": { "const": "PAGE_DELETE" }, "baseRevision": { "$ref": "#/$defs/RevisionString", "description": "Pages tree revision, not an individual Page or content version revision. Read the revision field from READ workspace/pages/tree before constructing this command." }, "commandId": { "$ref": "#/$defs/PageCommandId" } } } } }, "PageUploadCompleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "action": { "const": "complete" }, "input": { "type": "object", "additionalProperties": false, "required": [ "kind", "parts" ], "properties": { "kind": { "const": "PAGE_CONTENT_UPLOAD_COMPLETE" }, "parts": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "partNumber", "eTag" ], "properties": { "partNumber": { "type": "integer", "minimum": 1, "maximum": 10000 }, "eTag": { "type": "string", "minLength": 1, "maxLength": 200 } } }, "minItems": 1, "maxItems": 10000 } } } } }, "PageUploadAbortInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/PageUploadResourcePath" }, "action": { "const": "abort" } } }, "PageResourceBody": { "type": "object", "additionalProperties": false, "required": [ "pageKind", "title", "description", "displayTitle", "dashboard", "latestVersion", "documentFormat" ], "properties": { "pageKind": { "enum": [ "FOLDER", "DOCUMENT", "DASHBOARD" ] }, "title": { "anyOf": [ { "$ref": "#/$defs/PageTitle" }, { "type": "null" } ] }, "description": { "$ref": "#/$defs/PageDescription" }, "displayTitle": { "type": "string" }, "dashboard": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "DASHBOARD" }, "path": { "$ref": "#/$defs/DashboardResourcePath" } } }, { "type": "null" } ] }, "latestVersion": { "anyOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "path" ], "properties": { "kind": { "const": "PAGE_VERSION" }, "path": { "$ref": "#/$defs/PageVersionResourcePath" } } }, { "type": "null" } ] }, "documentFormat": { "enum": ["MARKDOWN", "NOTEBOOK", "HTML", null] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "createdBy": {"$ref": "#/$defs/PageActor"}, "updatedBy": {"$ref": "#/$defs/PageActor"} }, "allOf": [ { "if": { "properties": { "pageKind": { "const": "DASHBOARD" } } }, "then": { "properties": { "latestVersion": { "type": "null" } } }, "else": { "properties": { "dashboard": { "type": "null" } } } }, { "if": { "properties": { "pageKind": { "const": "FOLDER" } } }, "then": { "properties": { "latestVersion": { "type": "null" } } } } ] }, "PageVersionResourceBody": { "type": "object", "additionalProperties": false, "required": [ "format", "byteSize", "sha256", "finalizedAt", "finalizedBy" ], "properties": { "format": { "$ref": "#/$defs/PageContentFormat" }, "byteSize": { "$ref": "#/$defs/PageContentSize" }, "sha256": { "$ref": "#/$defs/PageContentHash" }, "finalizedAt": { "type": "string", "format": "date-time" }, "finalizedBy": {"$ref": "#/$defs/PageActor"} } }, "PageListingItem": { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "body" ], "properties": { "kind": { "const": "PAGE" }, "path": { "$ref": "#/$defs/PageResourcePath" }, "body": { "$ref": "#/$defs/PageResourceBody" } } }, "PageVersionListingItem": { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "body" ], "properties": { "kind": { "const": "PAGE_VERSION" }, "path": { "$ref": "#/$defs/PageVersionResourcePath" }, "body": { "$ref": "#/$defs/PageVersionResourceBody" } } }, "PagePlacement": { "type": "object", "additionalProperties": false, "required": [ "pageId", "children" ], "properties": { "pageId": { "$ref": "#/$defs/UuidV7" }, "children": { "type": "array", "items": { "$ref": "#/$defs/PagePlacement" } } } }, "PagesTreeResourceBody": { "type": "object", "additionalProperties": false, "required": [ "pages", "placements" ], "properties": { "pages": { "type": "array", "items": { "$ref": "#/$defs/PageListingItem" } }, "placements": { "type": "array", "items": { "$ref": "#/$defs/PagePlacement" } } } }, "PageUploadMetadata": { "type": "object", "additionalProperties": false, "required": [ "uploadRef", "format", "byteSize", "sha256", "expiresAt" ], "properties": { "uploadRef": { "$ref": "#/$defs/UuidV7" }, "format": { "$ref": "#/$defs/PageContentFormat" }, "byteSize": { "$ref": "#/$defs/PageContentSize" }, "sha256": { "$ref": "#/$defs/PageContentHash" }, "expiresAt": { "type": "string", "format": "date-time" } } }, "PageUploadPart": { "type": "object", "additionalProperties": false, "required": [ "partNumber", "contentLength", "url", "requiredHeaders" ], "properties": { "partNumber": { "type": "integer", "minimum": 1, "maximum": 10000 }, "contentLength": { "$ref": "#/$defs/PageContentSize" }, "url": { "type": "string", "format": "uri" }, "requiredHeaders": { "type": "object", "additionalProperties": { "type": "string" } } } }, "OrganizationCollectionPath": { "type": "string", "pattern": "^organization/(?:members|invitations|workspaces(?:/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/members)?)$" }, "OrganizationResourcePath": { "const": "organization" }, "OrganizationMemberPath": { "type": "string", "pattern": "^organization/members/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "OrganizationInvitationPath": { "type": "string", "pattern": "^organization/invitations/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "WorkspaceManagementCollectionPath": { "type": "string", "pattern": "^workspace/(?:members|member-candidates|lineage/(?:relations|semantic-models|metrics))$" }, "WorkspaceMemberPath": { "type": "string", "pattern": "^workspace/members/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "WorkspaceMemberCandidatePath": { "type": "string", "pattern": "^workspace/member-candidates/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "WorkspaceAccessPath": { "const": "workspace/access" }, "WorkspaceAuthorizationPath": { "const": "workspace/authorization" }, "LineageResourcePath": { "type": "string", "pattern": "^workspace/lineage/(?:relations|semantic-models|metrics)/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "AgentManagementResourceKind": { "enum": [ "RELATION", "SEMANTIC_MODEL", "METRIC" ] }, "AgentOrganizationRole": { "enum": [ "ADMIN", "MEMBER" ] }, "AgentInvitationStatus": { "enum": [ "PENDING", "EXPIRED" ] }, "AgentLineageMetricInputKind": { "enum": [ "MEASURE", "METRIC" ] }, "AgentMetricType": { "enum": [ "SIMPLE", "RATIO", "DERIVED", "CUMULATIVE", "CONVERSION" ] }, "AgentSemanticEntityKind": { "enum": [ "PRIMARY", "UNIQUE", "FOREIGN", "NATURAL" ] }, "AgentSemanticDimensionKind": { "enum": [ "CATEGORICAL", "TIME" ] }, "AgentSemanticAggregation": { "enum": [ "SUM", "COUNT", "COUNT_DISTINCT", "AVERAGE", "MIN", "MAX", "MEDIAN", "SUM_BOOLEAN" ] }, "AgentTimeGranularity": { "enum": [ "YEAR", "QUARTER", "MONTH", "WEEK", "DAY", "HOUR", "MINUTE", "SECOND", "MILLISECOND", "MICROSECOND", "NANOSECOND" ] }, "AgentConnectorProductType": { "enum": [ "POSTGRESQL", "BIGQUERY", "SNOWFLAKE", "DATABRICKS", "REDSHIFT", "TRINO", "DUCKDB" ] }, "AgentManagementResource": { "type": "object", "additionalProperties": false, "required": [ "kind", "id" ], "properties": { "kind": { "$ref": "#/$defs/AgentManagementResourceKind" }, "id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } } }, "AgentOrganizationSelf": { "type": "object", "additionalProperties": false, "required": [ "userId", "displayName", "role" ], "properties": { "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "role": { "$ref": "#/$defs/AgentOrganizationRole" } } }, "AgentOrganizationBody": { "type": "object", "additionalProperties": false, "required": [ "id", "displayName", "caller" ], "properties": { "id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "caller": { "$ref": "#/$defs/AgentOrganizationSelf" } } }, "AgentOrganizationMemberBody": { "type": "object", "additionalProperties": false, "required": [ "userId", "displayName", "email", "role" ], "properties": { "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "email": { "type": "string" }, "role": { "$ref": "#/$defs/AgentOrganizationRole" } } }, "AgentOrganizationInvitationBody": { "type": "object", "additionalProperties": false, "required": [ "id", "email", "status", "expiresAt", "createdAt", "workspaceAccess" ], "properties": { "id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "email": { "type": "string" }, "status": { "$ref": "#/$defs/AgentInvitationStatus" }, "expiresAt": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "lastDeliveryAttemptAt": { "type": "string", "format": "date-time" }, "lastSentAt": { "type": "string", "format": "date-time" }, "workspaceAccess": { "type": "array", "description": "Workspace access granted when the invitation is accepted. Workspaces no longer in the Organization are omitted.", "items": { "type": "object", "additionalProperties": false, "required": ["workspaceId", "workspaceDisplayName", "role"], "properties": { "workspaceId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "workspaceDisplayName": { "type": "string" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } } } } }, "AgentWorkspaceAccessBody": { "type": "object", "additionalProperties": false, "required": [ "organizationId", "authorizationRevision", "role", "reportingTimeZone" ], "properties": { "organizationId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "authorizationRevision": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "role": { "$ref": "#/$defs/WorkspaceRole" }, "reportingTimeZone": { "type": "string", "minLength": 1, "description": "The Workspace Reporting time zone, an IANA time zone identifier such as UTC or Asia/Seoul. Agents read it here; Owners and Organization Admins change it in Workspace settings." } } }, "AgentWorkspaceAuthorizationBody": { "type": "object", "additionalProperties": false, "required": [ "authorizationRevision", "members" ], "properties": { "authorizationRevision": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "members": { "type": "array", "items": { "$ref": "#/$defs/AgentWorkspaceMemberBodyMember" } } } }, "AgentLineageConnector": { "type": "object", "additionalProperties": false, "required": [ "id", "displayName", "type" ], "properties": { "id": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "type": { "$ref": "#/$defs/AgentConnectorProductType" } } }, "AgentLineageResource": { "type": "object", "additionalProperties": false, "required": [ "ref", "label", "address", "missing" ], "properties": { "ref": { "$ref": "#/$defs/AgentManagementResource" }, "label": { "type": "string" }, "address": { "type": "string" }, "description": { "type": "string" }, "connector": { "$ref": "#/$defs/AgentLineageConnector" }, "missing": { "type": "boolean", "description": "True for a referenced Semantic definition that no longer exists. Its id is only a graph placeholder, not a readable resource identity." } }, "allOf": [ { "if": { "properties": { "ref": { "properties": { "kind": { "const": "RELATION" } } } } }, "then": { "required": [ "connector" ] }, "else": { "not": { "required": [ "connector" ] } } } ] }, "AgentLineageEdge": { "type": "object", "additionalProperties": false, "required": [ "dependent", "parent" ], "properties": { "dependent": { "$ref": "#/$defs/AgentManagementResource" }, "parent": { "$ref": "#/$defs/AgentManagementResource" } } }, "AgentLineageEntityPeer": { "type": "object", "additionalProperties": false, "required": [ "resource", "sharedEntities", "alreadyInCone" ], "properties": { "resource": { "$ref": "#/$defs/AgentLineageResource" }, "sharedEntities": { "type": "array", "items": { "type": "string" } }, "alreadyInCone": { "type": "boolean" } } }, "AgentLineageColumn": { "type": "object", "additionalProperties": false, "required": [ "name", "nativeType", "nullable", "hasDefault", "primaryKey", "foreignKey" ], "properties": { "name": { "type": "string" }, "nativeType": { "type": "string" }, "nullable": { "type": "boolean" }, "hasDefault": { "type": "boolean" }, "primaryKey": { "type": "boolean" }, "foreignKey": { "type": "boolean" } } }, "AgentLineageEntity": { "type": "object", "additionalProperties": false, "required": [ "name", "type" ], "properties": { "name": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "type": { "$ref": "#/$defs/AgentSemanticEntityKind" } } }, "AgentLineageDimension": { "type": "object", "additionalProperties": false, "required": [ "name", "type" ], "properties": { "name": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "type": { "$ref": "#/$defs/AgentSemanticDimensionKind" }, "granularity": { "$ref": "#/$defs/AgentTimeGranularity" } } }, "AgentLineageMeasure": { "type": "object", "additionalProperties": false, "required": [ "name", "aggregation" ], "properties": { "name": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "aggregation": { "$ref": "#/$defs/AgentSemanticAggregation" } } }, "AgentLineageMetricInput": { "type": "object", "additionalProperties": false, "required": [ "kind", "name" ], "properties": { "kind": { "$ref": "#/$defs/AgentLineageMetricInputKind" }, "name": { "type": "string" }, "semanticModelName": { "type": "string" } }, "allOf": [ { "if": { "properties": { "kind": { "const": "MEASURE" } } }, "then": { "required": [ "semanticModelName" ] }, "else": { "not": { "required": [ "semanticModelName" ] } } } ] }, "AgentLineageDashboardUsage": { "type": "object", "additionalProperties": false, "required": [ "dashboardId", "title", "queryNames", "metricIds" ], "properties": { "dashboardId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "title": { "type": "string", "minLength": 1 }, "queryNames": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "metricIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } } } }, "AgentLineageResourceBody": { "type": "object", "additionalProperties": false, "required": [ "workspaceId", "focus", "ancestors", "descendants", "siblings", "edges", "siblingEdges", "entityPeers", "detail", "missingDefinitions", "dashboardUsages" ], "properties": { "workspaceId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "focus": { "$ref": "#/$defs/AgentLineageResource" }, "ancestors": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageResource" } }, "descendants": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageResource" } }, "siblings": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageResource" } }, "edges": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageEdge" } }, "siblingEdges": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageEdge" } }, "entityPeers": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageEntityPeer" } }, "detail": { "$ref": "#/$defs/AgentLineageDetail" }, "missingDefinitions": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageResource" } }, "dashboardUsages": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageDashboardUsage" } } }, "allOf": [ { "if": { "properties": { "focus": { "properties": { "ref": { "properties": { "kind": { "const": "RELATION" } } } } } } }, "then": { "properties": { "detail": { "required": [ "relation" ] } } } }, { "if": { "properties": { "focus": { "properties": { "ref": { "properties": { "kind": { "const": "SEMANTIC_MODEL" } } } } } } }, "then": { "properties": { "detail": { "required": [ "semanticModel" ] } } } }, { "if": { "properties": { "focus": { "properties": { "ref": { "properties": { "kind": { "const": "METRIC" } } } } } } }, "then": { "properties": { "detail": { "required": [ "metric" ] } } } } ] }, "AgentWorkspaceMemberBodyMember": { "type": "object", "additionalProperties": false, "required": [ "userId", "displayName", "email", "role" ], "properties": { "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "email": { "type": "string" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } }, "AgentWorkspaceMemberBodyCandidate": { "type": "object", "additionalProperties": false, "required": [ "userId", "displayName", "email" ], "properties": { "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "displayName": { "type": "string" }, "email": { "type": "string" } } }, "AgentWorkspaceMemberBody": { "oneOf": [ { "$ref": "#/$defs/AgentWorkspaceMemberBodyMember" }, { "$ref": "#/$defs/AgentWorkspaceMemberBodyCandidate" } ] }, "AgentLineageDetail": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "relation" ], "properties": { "relation": { "type": "object", "additionalProperties": false, "required": [ "columns" ], "properties": { "columns": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageColumn" } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "semanticModel" ], "properties": { "semanticModel": { "type": "object", "additionalProperties": false, "required": [ "entities", "dimensions", "measures" ], "properties": { "entities": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageEntity" } }, "dimensions": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageDimension" } }, "measures": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageMeasure" } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "metric" ], "properties": { "metric": { "type": "object", "additionalProperties": false, "required": [ "type", "inputs" ], "properties": { "type": { "$ref": "#/$defs/AgentMetricType" }, "inputs": { "type": "array", "items": { "$ref": "#/$defs/AgentLineageMetricInput" } }, "timeGranularity": { "$ref": "#/$defs/AgentTimeGranularity" } } } } } ] }, "OrganizationInvitationCreateInput": { "type": "object", "additionalProperties": false, "required": [ "kind", "email" ], "properties": { "kind": { "const": "ORGANIZATION_INVITATION_CREATE" }, "email": { "type": "string", "minLength": 3, "maxLength": 254, "pattern": "^\\s*[^\\s@]+@[^\\s@]+\\.[^\\s@]+\\s*$" }, "workspaceAccess": { "type": "array", "maxItems": 20, "description": "Optional Workspace access granted in the same transaction when the invitee accepts. Each Workspace must belong to this Organization and appear once.", "items": { "type": "object", "additionalProperties": false, "required": ["workspaceId", "role"], "properties": { "workspaceId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } } } } }, "WorkspaceMemberAddInput": { "type": "object", "additionalProperties": false, "required": [ "kind", "userId", "role" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER_ADD" }, "userId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } }, "OrganizationInvitationCreateRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "input" ], "properties": { "path": { "const": "organization/invitations" }, "input": { "$ref": "#/$defs/OrganizationInvitationCreateInput" } } }, "OrganizationInvitationResendInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "action": { "const": "resend" } } }, "OrganizationInvitationCancelInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/OrganizationInvitationPath" }, "action": { "const": "cancel" } } }, "WorkspaceMemberAddInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "const": "workspace/members" }, "action": { "const": "add-member" }, "input": { "$ref": "#/$defs/WorkspaceMemberAddInput" } } }, "WorkspaceMemberRemoveInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "action": { "const": "remove-member" } } }, "AgentOrganizationListRequest": { "allOf": [ { "$ref": "#/$defs/AgentListRequest" }, { "properties": { "path": { "$ref": "#/$defs/OrganizationCollectionPath" } } } ] }, "AgentOrganizationReadRequest": { "allOf": [ { "$ref": "#/$defs/AgentReadRequest" }, { "properties": { "path": { "oneOf": [ { "$ref": "#/$defs/OrganizationResourcePath" }, { "$ref": "#/$defs/OrganizationMemberPath" }, { "$ref": "#/$defs/OrganizationInvitationPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] } } } ] }, "AgentOrganizationCreateRequest": { "allOf": [ { "$ref": "#/$defs/AgentCreateRequest" }, { "properties": { "path": { "oneOf": [ { "$ref": "#/$defs/OrganizationCollectionPath" }, { "$ref": "#/$defs/OrganizationResourcePath" }, { "$ref": "#/$defs/OrganizationMemberPath" }, { "$ref": "#/$defs/OrganizationInvitationPath" } ] } } } ] }, "AgentOrganizationInvokeRequest": { "allOf": [ { "$ref": "#/$defs/AgentInvokeRequest" }, { "properties": { "path": { "oneOf": [ { "$ref": "#/$defs/OrganizationCollectionPath" }, { "$ref": "#/$defs/OrganizationResourcePath" }, { "$ref": "#/$defs/OrganizationMemberPath" }, { "$ref": "#/$defs/OrganizationInvitationPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] } } } ] }, "DashboardSchedulesResourcePath": { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/(?:draft/)?schedules$" }, "DashboardOccurrenceCollectionPath": { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/occurrences$" }, "DashboardOccurrenceResourcePath": { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/occurrences/(?!__proto__/)[A-Za-z_][A-Za-z0-9_]{0,127}/[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(?:\\.[0-9]{1,9})?Z$" }, "DashboardDefinitionSnapshot": { "$ref": "monomer://schema/dashboard/1" }, "DashboardSchedulesResourceBody": { "type": "object", "additionalProperties": false, "required": [ "schedules", "preview", "previewError" ], "properties": { "schedules": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "scheduleKey", "nextScheduledAt" ], "properties": { "scheduleKey": { "type": "string", "pattern": "^(?!__proto__$)[A-Za-z_][A-Za-z0-9_]{0,127}$" }, "nextScheduledAt": { "type": "string", "format": "date-time" } } } }, "preview": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "scheduleKey", "scheduledAt", "localTime", "parameters" ], "properties": { "scheduleKey": { "type": "string", "pattern": "^(?!__proto__$)[A-Za-z_][A-Za-z0-9_]{0,127}$" }, "scheduledAt": { "type": "string", "format": "date-time" }, "localTime": { "type": "string" }, "parameters": { "type": "object", "additionalProperties": { "$ref": "#/$defs/DashboardValue" } } } } }, "previewError": { "enum": [ null, "SCHEDULE_PREVIEW_UNAVAILABLE" ] } } }, "DashboardOccurrenceSummary": { "type": "object", "additionalProperties": false, "required": [ "scheduleKey", "scheduledAt", "decidedAt", "outcome", "reason", "sessionId", "resultState" ], "properties": { "scheduleKey": { "type": "string", "pattern": "^(?!__proto__$)[A-Za-z_][A-Za-z0-9_]{0,127}$" }, "scheduledAt": { "type": "string", "format": "date-time" }, "decidedAt": { "type": "string", "format": "date-time" }, "outcome": { "enum": [ "ACCEPTED", "SKIPPED", "ADMISSION_FAILED" ] }, "reason": { "type": [ "string", "null" ] }, "sessionId": { "type": [ "string", "null" ], "format": "uuid" }, "resultState": { "enum": [ null, "RUNNING", "READY", "PARTIAL_FAILURE", "FAILED", "UNAVAILABLE" ] } } }, "DashboardOccurrenceResourceBody": { "type": "object", "additionalProperties": false, "required": [ "scheduleKey", "scheduledAt", "decidedAt", "outcome", "reason", "definition", "parameters", "sessionId", "initialQueryRuns", "queryRuns", "resultState" ], "properties": { "scheduleKey": { "type": "string", "pattern": "^(?!__proto__$)[A-Za-z_][A-Za-z0-9_]{0,127}$" }, "scheduledAt": { "type": "string", "format": "date-time" }, "decidedAt": { "type": "string", "format": "date-time" }, "outcome": { "enum": [ "ACCEPTED", "SKIPPED", "ADMISSION_FAILED" ] }, "reason": { "type": [ "string", "null" ] }, "definition": { "$ref": "#/$defs/DashboardDefinitionSnapshot" }, "parameters": { "anyOf": [ { "type": "object", "additionalProperties": { "$ref": "#/$defs/DashboardValue" } }, { "type": "null" } ] }, "sessionId": { "type": [ "string", "null" ], "format": "uuid" }, "initialQueryRuns": { "type": "object", "additionalProperties": { "type": "string", "format": "uuid" } }, "queryRuns": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": false, "required": [ "queryRunId", "state", "failureCode", "failureMessage", "updatedAt", "resultAvailable" ], "properties": { "queryRunId": { "type": "string", "format": "uuid" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] }, "failureCode": { "description": "Stable Dashboard run failure code. Databricks Statement Execution API supports exact TIMESTAMP and canonical NUMBER (wire DECIMAL) binds within the published limits. QUERY_BIND_UNSUPPORTED marks a FAILED run when Monomer rejects any BYTES bind, including typed nulls, before submitting user SQL.", "type": [ "string", "null" ] }, "failureMessage": { "description": "Safe English failure message for Explorer or higher. QUERY_BIND_UNSUPPORTED identifies the rejected bind type and Databricks limitation with a correction hint, without SQL text, Connector details, or bound values; Page readers receive only QUERY_FAILED.", "type": [ "string", "null" ] }, "updatedAt": { "type": "string", "format": "date-time" }, "resultAvailable": { "type": "boolean" } } } }, "resultState": { "enum": [ null, "RUNNING", "READY", "PARTIAL_FAILURE", "FAILED", "UNAVAILABLE" ] } } }, "WorkspaceRole": { "enum": [ "VIEWER", "EXPLORER", "EDITOR", "OWNER" ] }, "WorkspaceMemberRoleInput": { "type": "object", "additionalProperties": false, "required": [ "kind", "role" ], "properties": { "kind": { "const": "WORKSPACE_MEMBER_ROLE" }, "role": { "$ref": "#/$defs/WorkspaceRole" } } }, "WorkspaceMemberRoleInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "oneOf": [ { "$ref": "#/$defs/WorkspaceMemberPath" }, { "$ref": "#/$defs/OrganizationWorkspaceMemberPath" } ] }, "action": { "const": "set-role" }, "input": { "$ref": "#/$defs/WorkspaceMemberRoleInput" } } }, "PageContentResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/content$" }, "PageSessionCollectionPath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions$" }, "PageSessionResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "PageRunCollectionPath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs$" }, "PageRunResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "PageResultResourcePath": { "type": "string", "pattern": "^workspace/pages/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/sessions/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/query-runs/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/result$" }, "PageContentResourceBody": { "type": "object", "additionalProperties": false, "required": [ "title", "format", "source" ], "properties": { "title": { "type": "string" }, "format": { "$ref": "#/$defs/PageContentFormat" }, "source": { "type": "string" } } }, "PageSessionResourceBody": { "type": "object", "additionalProperties": false, "required": [ "title", "display", "parameterBindings", "initialVariables", "createdAt", "updatedAt" ], "properties": { "title": { "type": [ "string", "null" ] }, "display": { "type": "object", "additionalProperties": false, "required": [ "parameters", "variables", "widgets", "layout", "queryNames", "queryTypes" ], "properties": { "parameters": { "type": "object" }, "variables": { "type": "object" }, "widgets": { "type": "object" }, "layout": { "type": "object" }, "queryNames": { "type": "array", "items": { "type": "string" } }, "queryTypes": { "type": "object", "additionalProperties": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } } }, "parameterBindings": { "$ref": "#/$defs/DashboardValueMap" }, "initialVariables": { "$ref": "#/$defs/DashboardValueMap" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "PageRunResourceBody": { "type": "object", "additionalProperties": false, "required": [ "queryName", "queryType", "state", "resultAvailable", "failureCode", "outputColumnNames", "createdAt", "updatedAt" ], "properties": { "queryName": { "type": "string" }, "state": { "enum": [ "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED" ] }, "resultAvailable": { "type": "boolean" }, "failureCode": { "enum": [ null, "QUERY_FAILED", "RESULT_UNAVAILABLE" ] }, "outputColumnNames": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "queryType": { "$ref": "monomer://schema/dashboard/1#/$defs/queryType" } } }, "PageSessionResolveInvokeRequest": { "type": "object", "description": "Select QueryRuns for an existing Dashboard Session through its currently connected Page when reading initial results or changing interactive Variable values as a Page reader. Checks current Page access and the Page-to-Dashboard connection, then validates complete variables and resolves every named query. Within this Session, reuses the latest matching SUCCEEDED run first, otherwise joins a matching RUNNING run, otherwise starts a new QueryRun; FAILED and CANCELLED runs are not reused. Does not open a Session, change the definition or immutable Parameters, store caller selections or readyResults, or force a refresh of successful results. Page readers are not offered Session open or refresh. Returns ACCEPTED with a PAGE_SESSION result.path, validated variables, and a complete queryRuns map from query name to Page QueryRun path. READ each path, observe RUNNING until terminal, and READ its advertised result child when SUCCEEDED. queryRuns is empty when no queries are declared.", "additionalProperties": false, "required": [ "path", "action", "input" ], "properties": { "path": { "$ref": "#/$defs/PageSessionResourcePath" }, "action": { "const": "resolve" }, "input": { "type": "object", "description": "Supply your complete Variable values for the existing Page Session. For initial results, copy initialVariables from the Page Session READ body.", "additionalProperties": false, "required": [ "kind", "variables" ], "properties": { "kind": { "const": "DASHBOARD_SESSION_RESOLVE" }, "variables": { "$ref": "#/$defs/DashboardValueMap", "description": "Complete map from every declared Variable name to its typed value, including explicit null for nullable Variables. Use the values you selected, or the Page Session READ body's initialVariables for initial inputs. This is not a patch and does not change the Session's Parameters. An empty map is valid only when the Session declares no Variables; it does not apply defaults or retain earlier values." } } } } }, "OrganizationWorkspaceMemberPath": { "type": "string", "pattern": "^organization/workspaces/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/members/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "SemanticModelHistoryPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/semantic-models/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?/history/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "SemanticModelVersionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/semantic-models/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?/history/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "SemanticModelDeleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/SemanticModelResourcePath" }, "action": { "const": "delete" } } }, "SemanticModelRestoreInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/SemanticModelVersionPath" }, "action": { "const": "restore" } } }, "SemanticModelVersionBody": { "type": "object", "additionalProperties": false, "required": [ "workspaceId", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "definition", "restorable" ], "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "pattern": "^(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "UPDATED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "definition": { "$ref": "monomer://schema/semantic/model/3" }, "restorable": { "type": "boolean", "description": "Computed by Semantic from the latest recorded definition. True for the latest Deleted entry, or an older entry with different definition JSON. False for the newest live entry and older identical definitions. Independent of caller role; restore requires Editor or higher." } } }, "SemanticModelVersionListingItem": { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "restorable" ], "properties": { "kind": { "const": "SEMANTIC_MODEL_VERSION" }, "path": { "$ref": "#/$defs/SemanticModelVersionPath" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "pattern": "^(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "UPDATED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "restorable": { "type": "boolean", "description": "Computed by Semantic from the latest recorded definition. True for the latest Deleted entry, or an older entry with different definition JSON. False for the newest live entry and older identical definitions. Independent of caller role; restore requires Editor or higher." } } }, "MetricHistoryPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/metrics/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?/history/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "MetricVersionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/metrics/(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?/history/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "MetricDeleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/MetricResourcePath" }, "action": { "const": "delete" } } }, "MetricRestoreInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/MetricVersionPath" }, "action": { "const": "restore" } } }, "MetricVersionBody": { "type": "object", "additionalProperties": false, "required": [ "workspaceId", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "definition", "restorable" ], "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "pattern": "^(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "UPDATED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "definition": { "$ref": "monomer://schema/semantic/metric/3" }, "restorable": { "type": "boolean", "description": "Computed by Semantic from the latest recorded definition. True for the latest Deleted entry, or an older entry with different definition JSON. False for the newest live entry and older identical definitions. Independent of caller role; restore requires Editor or higher." } } }, "MetricVersionListingItem": { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "restorable" ], "properties": { "kind": { "const": "METRIC_VERSION" }, "path": { "$ref": "#/$defs/MetricVersionPath" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string", "pattern": "^(?![a-z0-9_]*__)[a-z](?:[a-z0-9_]*[a-z0-9])?$" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "UPDATED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "restorable": { "type": "boolean", "description": "Computed by Semantic from the latest recorded definition. True for the latest Deleted entry, or an older entry with different definition JSON. False for the newest live entry and older identical definitions. Independent of caller role; restore requires Editor or higher." } } }, "DashboardHistoryPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/history$" } ] }, "DashboardVersionPath": { "allOf": [ { "$ref": "#/$defs/CanonicalResourcePath" }, { "type": "string", "pattern": "^workspace/dashboards/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/history/[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" } ] }, "DashboardDeleteInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/DashboardResourcePath" }, "action": { "const": "delete" } } }, "DashboardRestoreInvokeRequest": { "type": "object", "additionalProperties": false, "required": [ "path", "action" ], "properties": { "path": { "$ref": "#/$defs/DashboardVersionPath" }, "action": { "const": "restore" } } }, "DashboardVersionBody": { "type": "object", "additionalProperties": false, "required": [ "workspaceId", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "definition", "restorable" ], "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "APPLIED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "definition": { "$ref": "monomer://schema/dashboard/1" }, "restorable": { "type": "boolean", "description": "True for the latest DELETED or a distinct older definition while deleted; restore requires Explorer." } } }, "DashboardVersionListingItem": { "type": "object", "additionalProperties": false, "required": [ "kind", "path", "definitionId", "name", "deleted", "changeId", "action", "occurredAt", "actor", "credentialSurface", "agentApp", "restorable" ], "properties": { "kind": { "const": "DASHBOARD_VERSION" }, "path": { "$ref": "#/$defs/DashboardVersionPath" }, "definitionId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "deleted": { "type": "boolean" }, "changeId": { "type": "string", "format": "uuid" }, "action": { "enum": [ "CREATED", "APPLIED", "DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "actor": { "oneOf": [ { "$ref": "#/$defs/AgentActor" }, { "type": "null" } ] }, "credentialSurface": { "enum": [ "WEB", "AGENT", null ] }, "agentApp": { "oneOf": [ { "$ref": "#/$defs/AgentApp" }, { "type": "null" } ] }, "restorable": { "type": "boolean", "description": "True for the latest DELETED or a distinct older definition while deleted; restore requires Explorer." } } } } }