> ## Documentation Index > Fetch the complete documentation index at: https://chatobserver.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a version of a spreadsheet binding > Access document-bound client sessions, queries, schedules, bindings and write claims. Required scopes: `client:write`. ## OpenAPI ````yaml POST /api/v2/metrics/client/bindings/{bindingId}/versions openapi: 3.1.1 info: title: chatobserver public API version: '2026-09-09' description: >- Track AI visibility, manage prompts, inspect collected answers and citations, and integrate workspace data with your own tools. Visibility endpoints use workspace API keys. Data endpoints use scoped service-account keys; spreadsheet client endpoints use authorised client sessions. See the authentication guide for each credential type. contact: name: chatobserver support url: https://chatobserver.com/contact email: support@chatobserver.com servers: - url: https://app.chatobserver.com description: Production API security: - WorkspaceKey: [] - BearerKey: [] tags: - name: Workspace description: Validate access and list the workspace project and available platforms. - name: Prompts description: Create, schedule, organise, activate and retrieve tracked prompts. - name: Answers description: Retrieve collected AI answers, their analysis and visibility trends. - name: Brands description: Manage brands and compare their visibility in AI answers. - name: Sources and citations description: Analyse cited domains, pages and ownership across answers. - name: Visitor analytics description: Read website visitor and crawler analytics for the workspace. - name: Content opportunities description: Retrieve content-gap findings and recommendations for tracked prompts. - name: Usage description: Read workspace consumption and allowance summaries. - name: Data connections description: Discover authorised connections, source accounts and connector catalogues. - name: Data queries description: >- Create versioned queries, publish definitions and inspect integration contracts. - name: Data operations description: >- Execute, validate, cancel and inspect operations and page through result rows. - name: Data delivery description: Manage schedules, transfers, destinations and import workflows. - name: Data definitions description: Manage reusable definitions and their immutable versions. - name: Data webhooks description: >- Configure event delivery, inspect deliveries, replay events and rotate secrets. - name: Client authorisation description: Authorise spreadsheet clients using a user-approved challenge exchange. - name: Spreadsheet clients description: >- Access document-bound client sessions, queries, schedules, bindings and write claims. - name: AI visibility audits description: Create website visibility audits and retrieve their report links. - name: Version 1 description: Integrate with the version 1 visibility and analytics endpoints. paths: /api/v2/metrics/client/bindings/{bindingId}/versions: post: tags: - Spreadsheet clients summary: Create a version of a spreadsheet binding description: >- Access document-bound client sessions, queries, schedules, bindings and write claims. Required scopes: `client:write`. operationId: postV2MetricsClientBindingsBindingIdVersions parameters: - name: x-metrics-client-audience in: header required: true schema: enum: - chatobserver-metrics-sheets - chatobserver-metrics-excel type: string description: The audience bound to the authorised client session. - name: x-metrics-document-reference in: header required: true schema: type: string pattern: ^[a-f0-9]{64}$ description: The document reference hash bound to the client session. - name: bindingId in: path required: true schema: type: string format: uuid description: Resource identifier returned by the API. - name: Idempotency-Key in: header required: true schema: type: string minLength: 16 maxLength: 160 pattern: ^[A-Za-z0-9:_-]+$ description: >- Unique key for one logical command. Reuse it only when retrying the same request and payload. requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/postV2MetricsClientBindingsBindingIdVersionsRequest responses: '200': description: Successful response. content: application/json: schema: $ref: >- #/components/schemas/postV2MetricsClientBindingsBindingIdVersionsResponse200 '201': description: Created successfully. content: application/json: schema: $ref: >- #/components/schemas/postV2MetricsClientBindingsBindingIdVersionsResponse201 default: description: >- Request failed. Inspect the error code and request identifier; retry only when the failure is retryable. content: application/json: schema: $ref: '#/components/schemas/DataError' security: - ClientSession: [] components: schemas: postV2MetricsClientBindingsBindingIdVersionsRequest: type: object properties: definition: anyOf: - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: google_sheets targetIdentity: type: object properties: sheetName: type: string spreadsheetReferenceHash: type: string stableSheetId: type: number required: - sheetName - spreadsheetReferenceHash - stableSheetId placement: type: object properties: anchorRow: type: number anchorColumn: type: number selectedRangeA1: type: string lastWrittenRangeA1: anyOf: - type: 'null' - type: string required: - anchorRow - anchorColumn - selectedRangeA1 - lastWrittenRangeA1 outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: excel targetIdentity: type: object properties: workbookReferenceHash: type: string stableWorksheetId: type: string worksheetName: type: string storageKind: enum: - onedrive - sharepoint - local type: string required: - workbookReferenceHash - stableWorksheetId - worksheetName - storageKind placement: type: object properties: tableName: anyOf: - type: 'null' - type: string anchorRow: type: number anchorColumn: type: number selectedAddress: type: string lastWrittenAddress: anyOf: - type: 'null' - type: string required: - tableName - anchorRow - anchorColumn - selectedAddress - lastWrittenAddress outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: looker_studio targetIdentity: type: object properties: dataSourceReferenceHash: type: string reportReferenceHash: anyOf: - type: 'null' - type: string credentialOwnership: enum: - owner - viewer type: string required: - dataSourceReferenceHash - reportReferenceHash - credentialOwnership placement: type: object properties: selectedFieldIds: type: array items: type: string dataSourceName: type: string defaultDateFieldId: anyOf: - type: 'null' - type: string required: - selectedFieldIds - dataSourceName - defaultDateFieldId outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string performance: type: object properties: maximumRows: type: number refreshMode: enum: - live_operation - latest_retained_result type: string maximumWaitSeconds: type: number resultPageSize: type: number imagePolicy: enum: - url - download type: string required: - maximumRows - refreshMode - maximumWaitSeconds - resultPageSize - imagePolicy refreshFieldsOnCatalogueChange: anyOf: - type: boolean const: false - type: boolean const: true sharing: type: object properties: allowCredentialSharing: anyOf: - type: boolean const: false - type: boolean const: true requireWorkspaceMembership: anyOf: - type: boolean const: false - type: boolean const: true required: - allowCredentialSharing - requireWorkspaceMembership required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion - performance - refreshFieldsOnCatalogueChange - sharing - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: power_bi targetIdentity: type: object properties: tenantReferenceHash: anyOf: - type: 'null' - type: string workspaceReferenceHash: anyOf: - type: 'null' - type: string datasetReferenceHash: type: string storageMode: type: string const: import required: - tenantReferenceHash - workspaceReferenceHash - datasetReferenceHash - storageMode placement: type: object properties: tableName: type: string selectedFieldIds: type: array items: type: string semanticModelName: type: string required: - tableName - selectedFieldIds - semanticModelName outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string performance: type: object properties: maximumRows: type: number refreshMode: enum: - live_operation - latest_retained_result type: string maximumWaitSeconds: type: number resultPageSize: type: number imagePolicy: enum: - url - download type: string required: - maximumRows - refreshMode - maximumWaitSeconds - resultPageSize - imagePolicy scheduledRefresh: type: object properties: managedBy: enum: - chatobserver - power_bi type: string gatewayRequired: anyOf: - type: boolean const: false - type: boolean const: true privacyLevel: enum: - private - organizational type: string required: - managedBy - gatewayRequired - privacyLevel required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion - performance - scheduledRefresh - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: chatobserver_report targetIdentity: type: object properties: reportId: type: string pageId: type: string blockId: type: string required: - reportId - pageId - blockId placement: type: object properties: anchor: anyOf: - type: 'null' - type: string container: type: string const: report_block rangeOrTable: anyOf: - type: 'null' - type: string required: - anchor - container - rangeOrTable outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion - type: object properties: input: anyOf: - type: object properties: kind: type: string const: query queryVersionId: type: string required: - kind - queryVersionId - type: object properties: kind: type: string const: model modelVersionId: type: string required: - kind - modelVersionId - type: object properties: kind: type: string const: table_group tableGroupVersionId: type: string required: - kind - tableGroupVersionId - type: object properties: kind: type: string const: managed_dataset managedDatasetVersionId: type: string required: - kind - managedDatasetVersionId - type: object properties: kind: type: string const: imported_dataset importedDatasetVersionId: type: string required: - kind - importedDatasetVersionId schemaVersion: type: number const: 3 ownership: type: object properties: ownerUserId: type: string hostOwnerReference: anyOf: - type: 'null' - type: string required: - ownerUserId - hostOwnerReference clientKind: type: string const: api_export targetIdentity: type: object properties: label: type: string consumerReferenceHash: type: string serviceAccountId: type: string required: - label - consumerReferenceHash - serviceAccountId placement: type: object properties: anchor: anyOf: - type: 'null' - type: string container: type: string const: result_pages rangeOrTable: anyOf: - type: 'null' - type: string required: - anchor - container - rangeOrTable outputShape: enum: - table_group - pivot - rows - semantic_model type: string writePolicy: type: object properties: mode: enum: - replace - append - incremental - combine type: string schemaDriftPolicy: enum: - replace - fail - add_columns type: string partialWritePolicy: enum: - resume - rollback type: string incrementalKeyFieldIds: type: array items: type: string preserveOutputOnFailure: anyOf: - type: boolean const: false - type: boolean const: true maximumRowsPerBatch: type: number required: - mode - schemaDriftPolicy - partialWritePolicy - incrementalKeyFieldIds - preserveOutputOnFailure - maximumRowsPerBatch formatting: type: object properties: timeZone: type: string locale: type: string preserveExisting: anyOf: - type: boolean const: false - type: boolean const: true writeHeaders: anyOf: - type: boolean const: false - type: boolean const: true applyNumberFormats: anyOf: - type: boolean const: false - type: boolean const: true freezeHeaderRow: anyOf: - type: boolean const: false - type: boolean const: true resizeColumns: enum: - never - new_columns - all_columns type: string required: - timeZone - locale - preserveExisting - writeHeaders - applyNumberFormats - freezeHeaderRow - resizeColumns parameterBindings: type: array items: anyOf: - type: object properties: value: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' kind: type: string const: literal parameterId: type: string required: - value - kind - parameterId - type: object properties: kind: type: string const: cell valueType: enum: - string - number - boolean - date - datetime type: string parameterId: type: string stableSheetReference: type: string rangeA1: type: string blankPolicy: enum: - use_null - use_default - fail type: string errorPolicy: enum: - use_default - fail type: string required: - kind - valueType - parameterId - stableSheetReference - rangeA1 - blankPolicy - errorPolicy - type: object properties: kind: type: string const: host_parameter valueType: enum: - string - number - boolean - date - datetime type: string allowViewerOverride: anyOf: - type: boolean const: false - type: boolean const: true parameterId: type: string blankPolicy: enum: - use_null - use_default - fail type: string hostParameterName: type: string required: - kind - valueType - allowViewerOverride - parameterId - blankPolicy - hostParameterName unattendedAccess: anyOf: - type: boolean const: false - type: boolean const: true credentialReferenceVersion: anyOf: - type: 'null' - type: string required: - input - schemaVersion - ownership - clientKind - targetIdentity - placement - outputShape - writePolicy - formatting - parameterBindings - unattendedAccess - credentialReferenceVersion required: - definition postV2MetricsClientBindingsBindingIdVersionsResponse200: type: object properties: data: type: object properties: actorId: type: string canonicalHash: type: string resourceId: type: string resourceType: enum: - model - table_group - imported_dataset - client_binding - blend - custom_field type: string versionId: type: string versionNumber: type: number versionStatus: type: string required: - actorId - canonicalHash - resourceId - resourceType - versionId - versionNumber - versionStatus replayed: anyOf: - type: boolean const: false - type: boolean const: true required: - data - replayed postV2MetricsClientBindingsBindingIdVersionsResponse201: type: object properties: data: type: object properties: actorId: type: string canonicalHash: type: string resourceId: type: string resourceType: enum: - model - table_group - imported_dataset - client_binding - blend - custom_field type: string versionId: type: string versionNumber: type: number versionStatus: type: string required: - actorId - canonicalHash - resourceId - resourceType - versionId - versionNumber - versionStatus replayed: anyOf: - type: boolean const: false - type: boolean const: true required: - data - replayed DataError: type: object properties: error: type: object properties: code: enum: - internal - validation_failed - authentication_required - forbidden - not_found - conflict - precondition_failed - idempotency_conflict - capability_unavailable - connection_unavailable - reauthentication_required - provider_rate_limited - workspace_limit_exceeded - result_expired - operation_failed - temporarily_unavailable type: string fieldPath: type: array items: anyOf: - type: string - type: number parameters: type: object properties: {} additionalProperties: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true repairActions: type: array items: type: string minLength: 1 maxLength: 96 maxItems: 10 requestId: type: string minLength: 1 maxLength: 160 retryable: anyOf: - type: boolean const: false - type: boolean const: true retryAfterSeconds: anyOf: - type: 'null' - type: integer exclusiveMinimum: 0 required: - code - fieldPath - parameters - repairActions - requestId - retryable - retryAfterSeconds additionalProperties: false required: - error additionalProperties: false ContractType54286: anyOf: - type: 'null' - type: string - type: number - type: boolean const: false - type: boolean const: true - type: array items: $ref: '#/components/schemas/ContractType54286' - type: object properties: {} additionalProperties: $ref: '#/components/schemas/ContractType54286' securitySchemes: WorkspaceKey: type: apiKey in: header name: x-chatobserver-key description: >- A workspace API key. Data endpoints require a service-account key with the specified scopes. BearerKey: type: http scheme: bearer description: The workspace or service-account API key as a bearer token. ClientSession: type: http scheme: bearer description: >- A client session token obtained through the client authorisation challenge flow. ````