> ## Documentation Index
> Fetch the complete documentation index at: https://arize-ax.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Data import mutations

> Control file and table import jobs, integration keys and BYOB connectors. Arguments, return types and a validated example for each of the 24 mutations.

Control file and table import jobs, integration keys and BYOB connectors.

For task-oriented walkthroughs of these operations, see the [Data import guide](/docs/ax/graphql-reference/guides/data-import). Every mutation below is sent as a `POST` to `https://app.arize.com/graphql` with an `x-api-key` header; see [Forming calls](/docs/ax/graphql-reference/overview/how-to-use-graphql/forming-calls).

## Mutations in this page

* [`createFileImportJob`](#createfileimportjob): Create a job that will import model inferences from a blob store
* [`updateFileImportJob`](#updatefileimportjob): Update an existing job that has been imported from a blob store
* [`startFileImportJob`](#startfileimportjob): Start an existing job that has been imported from a blob store
* [`pauseFileImportJob`](#pausefileimportjob): Pause an existing job that has been imported from a blob store
* [`deleteFileImportJob`](#deletefileimportjob): Delete an existing job that has been imported from a blob store
* [`resetFileStatus`](#resetfilestatus): Reset the status of a file
* [`createTableImportJob`](#createtableimportjob): Create a job that will import model inferences from a table
* [`updateTableImportJob`](#updatetableimportjob): Update an existing job that has been imported from a table
* [`updateTableIngestionParameters`](#updatetableingestionparameters): Update an existing job that has been imported from a table
* [`startTableImportJob`](#starttableimportjob): Start an existing job that has been imported from a table
* [`pauseTableImportJob`](#pausetableimportjob): Pause an existing job that has been imported from a table
* [`deleteTableImportJob`](#deletetableimportjob): Delete an existing job that has been imported from a table
* [`createTriggeredOngoingTableImportJob`](#createtriggeredongoingtableimportjob): Create a job that will import model inferences from a table
* [`createTriggeredOngoingTableRun`](#createtriggeredongoingtablerun): Schedule a job run that will import model inferences from a table
* [`createIntegrationKey`](#createintegrationkey): Create integration key.
* [`patchIntegrationKey`](#patchintegrationkey): Patch integration key.
* [`testIntegrationKey`](#testintegrationkey): Test integration key.
* [`deleteIntegrationKey`](#deleteintegrationkey): Delete integration key.
* [`validateByobConnector`](#validatebyobconnector): Validate a byob connector
* [`createByobConnector`](#createbyobconnector): Create a byob connector
* [`updateByobConnector`](#updatebyobconnector): Update a byob connector
* [`deleteByobConnector`](#deletebyobconnector): Delete a byob connector
* [`updateByobSyncedDatasource`](#updatebyobsynceddatasource): Update a byob synced datasource
* [`deleteByobDatasource`](#deletebyobdatasource): Delete a byob datasource

## Reference

### createFileImportJob

Create a job that will import model inferences from a blob store

`createFileImportJob(input: CreateFileImportJobInput!): CreateFileImportJobPayload`

#### Arguments

<ParamField body="input" type="CreateFileImportJobInput!" required>
  <Expandable title="CreateFileImportJobInput fields">
    <ParamField body="spaceId" type="ID!" required>
      The space id for the space under which the model should be ingested
    </ParamField>

    <ParamField body="azureStorageIdentifier" type="AzureStorageIdentifier">
      Additional information required to locate an Azure container. Required when running with an Azure service principal or managed identity.

      <Expandable title="AzureStorageIdentifier fields">
        <ParamField body="tenantId" type="String!" required>
          The Azure Active Directory Tenant ID associated with the Storage Account.
        </ParamField>

        <ParamField body="storageAccountName" type="String!" required>
          The Azure Storage Account name.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="modelName" type="String!" required>
      The model identifier or name under which the model will be stored.
    </ParamField>

    <ParamField body="modelType" type="ModelType!" required>
      The type of model. This determines how the model will be analyzed One of: `numeric`, `score_categorical`, `ranking`, `object_detection`, `generative_llm`, `multi_class`.
    </ParamField>

    <ParamField body="modelEnvironmentName" type="ModelEnvironmentName!" required>
      The environment for which the inferences are being ingested One of: `production`, `validation`, `training`, `tracing`.
    </ParamField>

    <ParamField body="batchId" type="String">
      A name for the ingestion batch. Only required if the environment is validation
    </ParamField>

    <ParamField body="modelVersion" type="String">
      The model version. This will tag all the inferences as being for a specific version string.
    </ParamField>

    <ParamField body="blobStore" type="BlobStoreType!" required>
      The cloud storage solution where the files reside One of: `S3`, `GCS`, `Azure`.
    </ParamField>

    <ParamField body="bucketName" type="String!" required>
      The bucket where the files are stored. Arize must have access to this bucket
    </ParamField>

    <ParamField body="prefix" type="String!" required>
      The path to the files. Ex. cc\_model
    </ParamField>

    <ParamField body="schema" type="FileImportSchemaInputType!" required>
      The schema for the CSV or Parquet files. The schema describes a mapping from your column names to model dimensions

      <Expandable title="FileImportSchemaInputType fields">
        <ParamField body="predictionId" type="String">
          The name of the predictionId column in the file
        </ParamField>

        <ParamField body="predictionGroupId" type="String">
          The name of the predictionGroupId column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="features" type="String">
          A prefix capture group used to match feature columns
        </ParamField>

        <ParamField body="featuresList" type="[String!]">
          A list of column names specifying features
        </ParamField>

        <ParamField body="timestamp" type="String">
          The name of the timestamp column in the file
        </ParamField>

        <ParamField body="predictionLabel" type="String">
          The name of the prediction label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="predictionScore" type="String">
          The name of the prediction score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="predictionScores" type="String">
          The name of the prediction scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="actualLabel" type="String">
          The name of the actual label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="actualScore" type="String">
          The name of the actual score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="actualScores" type="String">
          The name of the actual scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="thresholdScores" type="String">
          The name of the threshold scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="relevanceLabel" type="String">
          The name of the relevance label column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="relevanceScore" type="String">
          The name of the relevance score column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="version" type="String">
          The name of the model version column in the file
        </ParamField>

        <ParamField body="batchId" type="String">
          The name of the validation batch id. Required if the model is type validation
        </ParamField>

        <ParamField body="tags" type="String">
          A prefix capture group used to match tag column
        </ParamField>

        <ParamField body="tagsList" type="[String!]">
          A list of column names specifying tags
        </ParamField>

        <ParamField body="shapValues" type="String">
          A regex like capture group that should be used to match shap column
        </ParamField>

        <ParamField body="rank" type="String">
          The name of the rank column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="exclude" type="[String!]">
          The names of fields to be excluded from data ingestion
        </ParamField>

        <ParamField body="embeddingFeatures" type="[FileImportEmbeddingInputType!]">
          The embedding fields that will be ingested

          <Expandable title="FileImportEmbeddingInputType fields">
            <ParamField body="featureName" type="String!" required>
              The embedding feature name
            </ParamField>

            <ParamField body="vectorCol" type="String!" required>
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String">
              The name of the raw data column
            </ParamField>

            <ParamField body="linkToDataCol" type="String">
              The name of the link to data column
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="prompt" type="FileImportPromptResponseInputType">
          The columns which contain the prompt used in a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="response" type="FileImportPromptResponseInputType">
          The columns which contain the response from a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="promptTemplate" type="FileImportPromptTemplateInputType">
          The columns which contain the prompt template fields, such as the template and template version. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptTemplateInputType fields">
            <ParamField body="template" type="String">
              The name of the column which contains the prompt template
            </ParamField>

            <ParamField body="templateVersion" type="String">
              The name of the column which contains the prompt template version
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="llmConfig" type="FileImportLlmConfigInputType">
          The columns which contain the llm config fields, such as the llm name and params. Relevant if the model is generative\_llm

          <Expandable title="FileImportLlmConfigInputType fields">
            <ParamField body="llmName" type="String">
              The name of the column which contains the llm name
            </ParamField>

            <ParamField body="llmParams" type="String">
              The name of the column which contains a map of llm params to values
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="runMetadata" type="FileImportRunMetadataInputType">
          The columns which contain the metadata relevant to the llm call that was used to generate the response using the prompt. Relevant if the model is generative\_llm

          <Expandable title="FileImportRunMetadataInputType fields">
            <ParamField body="totalTokenCount" type="String">
              The name of the column which contains the total number of tokens used in the llm call
            </ParamField>

            <ParamField body="promptTokenCount" type="String">
              The name of the column which contains the number of prompt tokens in the llm call
            </ParamField>

            <ParamField body="responseTokenCount" type="String">
              The name of the column which contains the number of response tokens in the llm call
            </ParamField>

            <ParamField body="responseLatencyMs" type="String">
              The name of the column which contains the response latency in ms of the llm call
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="predictionObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection prediction fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="actualObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection actual fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="fileName" type="String">
      The name of the file to perform a dry run on (ex. test-file.avro). If a file name is not selected, the dry run will be performed on the first file
    </ParamField>

    <ParamField body="dryRun" type="Boolean">
      If true, the import job will be attempted but no changes will be written. The fileResult field may be requested to check the validation status. Default is false
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="space" type="Space">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

<ResponseField name="validationResult" type="JobValidationResult">
  <Expandable title="JobValidationResult fields">
    Scalar fields: `filePath`, `validationStatus`.

    Object fields (select subfields): `error`.
  </Expandable>
</ResponseField>

<ResponseField name="filePreview" type="FilePreviewResult">
  <Expandable title="FilePreviewResult fields">
    Scalar fields: `filePath`.

    Object fields (select subfields): `columnMetadata`, `rows`, `errorCode`.
  </Expandable>
</ResponseField>

<ResponseField name="fileImportJob" type="FileImportJob">
  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateFileImportJob($input: CreateFileImportJobInput!) {
    createFileImportJob(input: $input) {
      space { id name }
      validationResult { filePath }
      filePreview { filePath }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "spaceId": "<ID>",
      "modelName": "<string>",
      "modelType": "numeric",
      "modelEnvironmentName": "production",
      "blobStore": "S3",
      "bucketName": "<string>",
      "prefix": "<string>",
      "schema": {}
    }
  }
  ```
</CodeGroup>

### updateFileImportJob

Update an existing job that has been imported from a blob store

`updateFileImportJob(input: UpdateFileImportJobInput!): UpdateFileImportJobPayload`

#### Arguments

<ParamField body="input" type="UpdateFileImportJobInput!" required>
  <Expandable title="UpdateFileImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to delete
    </ParamField>

    <ParamField body="jobStatus" type="JobStatus">
      The status of the imported job One of: `ONGOING_INACTIVE`, `ONGOING_DELETED`.
    </ParamField>

    <ParamField body="schema" type="FileImportSchemaInputType!" required>
      The schema for the CSV or Parquet files. The schema describes a mapping from your column names to model dimensions

      <Expandable title="FileImportSchemaInputType fields">
        <ParamField body="predictionId" type="String">
          The name of the predictionId column in the file
        </ParamField>

        <ParamField body="predictionGroupId" type="String">
          The name of the predictionGroupId column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="features" type="String">
          A prefix capture group used to match feature columns
        </ParamField>

        <ParamField body="featuresList" type="[String!]">
          A list of column names specifying features
        </ParamField>

        <ParamField body="timestamp" type="String">
          The name of the timestamp column in the file
        </ParamField>

        <ParamField body="predictionLabel" type="String">
          The name of the prediction label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="predictionScore" type="String">
          The name of the prediction score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="predictionScores" type="String">
          The name of the prediction scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="actualLabel" type="String">
          The name of the actual label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="actualScore" type="String">
          The name of the actual score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="actualScores" type="String">
          The name of the actual scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="thresholdScores" type="String">
          The name of the threshold scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="relevanceLabel" type="String">
          The name of the relevance label column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="relevanceScore" type="String">
          The name of the relevance score column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="version" type="String">
          The name of the model version column in the file
        </ParamField>

        <ParamField body="batchId" type="String">
          The name of the validation batch id. Required if the model is type validation
        </ParamField>

        <ParamField body="tags" type="String">
          A prefix capture group used to match tag column
        </ParamField>

        <ParamField body="tagsList" type="[String!]">
          A list of column names specifying tags
        </ParamField>

        <ParamField body="shapValues" type="String">
          A regex like capture group that should be used to match shap column
        </ParamField>

        <ParamField body="rank" type="String">
          The name of the rank column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="exclude" type="[String!]">
          The names of fields to be excluded from data ingestion
        </ParamField>

        <ParamField body="embeddingFeatures" type="[FileImportEmbeddingInputType!]">
          The embedding fields that will be ingested

          <Expandable title="FileImportEmbeddingInputType fields">
            <ParamField body="featureName" type="String!" required>
              The embedding feature name
            </ParamField>

            <ParamField body="vectorCol" type="String!" required>
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String">
              The name of the raw data column
            </ParamField>

            <ParamField body="linkToDataCol" type="String">
              The name of the link to data column
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="prompt" type="FileImportPromptResponseInputType">
          The columns which contain the prompt used in a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="response" type="FileImportPromptResponseInputType">
          The columns which contain the response from a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="promptTemplate" type="FileImportPromptTemplateInputType">
          The columns which contain the prompt template fields, such as the template and template version. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptTemplateInputType fields">
            <ParamField body="template" type="String">
              The name of the column which contains the prompt template
            </ParamField>

            <ParamField body="templateVersion" type="String">
              The name of the column which contains the prompt template version
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="llmConfig" type="FileImportLlmConfigInputType">
          The columns which contain the llm config fields, such as the llm name and params. Relevant if the model is generative\_llm

          <Expandable title="FileImportLlmConfigInputType fields">
            <ParamField body="llmName" type="String">
              The name of the column which contains the llm name
            </ParamField>

            <ParamField body="llmParams" type="String">
              The name of the column which contains a map of llm params to values
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="runMetadata" type="FileImportRunMetadataInputType">
          The columns which contain the metadata relevant to the llm call that was used to generate the response using the prompt. Relevant if the model is generative\_llm

          <Expandable title="FileImportRunMetadataInputType fields">
            <ParamField body="totalTokenCount" type="String">
              The name of the column which contains the total number of tokens used in the llm call
            </ParamField>

            <ParamField body="promptTokenCount" type="String">
              The name of the column which contains the number of prompt tokens in the llm call
            </ParamField>

            <ParamField body="responseTokenCount" type="String">
              The name of the column which contains the number of response tokens in the llm call
            </ParamField>

            <ParamField body="responseLatencyMs" type="String">
              The name of the column which contains the response latency in ms of the llm call
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="predictionObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection prediction fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="actualObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection actual fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="fileImportJob" type="FileImportJob!">
  The updated import job

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation UpdateFileImportJob($input: UpdateFileImportJobInput!) {
    updateFileImportJob(input: $input) {
      fileImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>",
      "schema": {}
    }
  }
  ```
</CodeGroup>

### startFileImportJob

Start an existing job that has been imported from a blob store

`startFileImportJob(input: StartFileImportJobInput!): StartFileImportJobPayload`

#### Arguments

<ParamField body="input" type="StartFileImportJobInput!" required>
  <Expandable title="StartFileImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to start
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="fileImportJob" type="FileImportJob!">
  The import job which has been started

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation StartFileImportJob($input: StartFileImportJobInput!) {
    startFileImportJob(input: $input) {
      fileImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### pauseFileImportJob

Pause an existing job that has been imported from a blob store

`pauseFileImportJob(input: PauseFileImportJobInput!): PauseFileImportJobPayload`

#### Arguments

<ParamField body="input" type="PauseFileImportJobInput!" required>
  <Expandable title="PauseFileImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to pause
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="fileImportJob" type="FileImportJob!">
  The paused import job

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation PauseFileImportJob($input: PauseFileImportJobInput!) {
    pauseFileImportJob(input: $input) {
      fileImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### deleteFileImportJob

Delete an existing job that has been imported from a blob store

`deleteFileImportJob(input: DeleteFileImportJobInput!): DeleteFileImportJobPayload`

#### Arguments

<ParamField body="input" type="DeleteFileImportJobInput!" required>
  <Expandable title="DeleteFileImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to delete
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="fileImportJob" type="FileImportJob!">
  The deleted import job

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation DeleteFileImportJob($input: DeleteFileImportJobInput!) {
    deleteFileImportJob(input: $input) {
      fileImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### resetFileStatus

Reset the status of a file

`resetFileStatus(input: ResetFileStatusInput!): ResetFileStatusPayload`

#### Arguments

<ParamField body="input" type="ResetFileStatusInput!" required>
  <Expandable title="ResetFileStatusInput fields">
    <ParamField body="jobId" type="ID!" required>
      The id of the job to reset the status of
    </ParamField>

    <ParamField body="fileId" type="ID!" required>
      The id of the file to reset the status of
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="job" type="FileImportJob!">
  The updated import job

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation ResetFileStatus($input: ResetFileStatusInput!) {
    resetFileStatus(input: $input) {
      job { id }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>",
      "fileId": "<ID>"
    }
  }
  ```
</CodeGroup>

### createTableImportJob

Create a job that will import model inferences from a table

`createTableImportJob(input: CreateTableImportJobInput!): CreateTableImportJobPayload`

#### Arguments

<ParamField body="input" type="CreateTableImportJobInput!" required>
  <Expandable title="CreateTableImportJobInput fields">
    <ParamField body="spaceId" type="ID!" required>
      The space id for the space under which the model should be ingested
    </ParamField>

    <ParamField body="modelName" type="String!" required>
      The model identifier or name under which the model will be stored.
    </ParamField>

    <ParamField body="modelType" type="ModelType!" required>
      The type of model. This determines how the model will be analyzed One of: `numeric`, `score_categorical`, `ranking`, `object_detection`, `generative_llm`, `multi_class`.
    </ParamField>

    <ParamField body="modelEnvironmentName" type="ModelEnvironmentName!" required>
      The environment for which the inferences are being ingested One of: `production`, `validation`, `training`, `tracing`.
    </ParamField>

    <ParamField body="batchId" type="String">
      A name for the ingestion batch. Only required if the environment is validation
    </ParamField>

    <ParamField body="modelVersion" type="String">
      The model version. This will tag all the inferences as being for a specific version string.
    </ParamField>

    <ParamField body="tableStore" type="TableIntegrationType!" required>
      The table solution where the inferences reside One of: `BigQuery`, `Snowflake`, `Databricks`.
    </ParamField>

    <ParamField body="bigQueryTableConfig" type="BigQueryTableConfig">
      <Expandable title="BigQueryTableConfig fields">
        <ParamField body="projectId" type="String!" required>
          The unique string used to differentiate a Google Cloud project
        </ParamField>

        <ParamField body="dataset" type="String!" required>
          The dataset where the tables are stored. Arize must have access to this dataset
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The path to the table
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="snowflakeTableConfig" type="SnowflakeTableConfig">
      <Expandable title="SnowflakeTableConfig fields">
        <ParamField body="accountID" type="String!" required>
          The account identifier assigned to the Snowflake account.
        </ParamField>

        <ParamField body="schema" type="String!" required>
          The schema which the target Table belongs to. Together, a database and schema comprise a namespace in Snowflake.
        </ParamField>

        <ParamField body="database" type="String!" required>
          The database which the schema of the target Table belongs to.
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The table which to import data from.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="databricksTableConfig" type="DatabricksTableConfig">
      <Expandable title="DatabricksTableConfig fields">
        <ParamField body="hostname" type="String!" required>
          The base URL of the workspace ex. databricks-hostname-example.databricks.com
        </ParamField>

        <ParamField body="endpoint" type="String!" required>
          The URL fragment that corresponds to the resource, either a Compute Cluster or SQL Warehouse ex. /sql/1.0/warehouses/example
        </ParamField>

        <ParamField body="port" type="String!" required>
          The port of the resource ex. 443
        </ParamField>

        <ParamField body="token" type="String">
          Personal access token (for a service principal) ex. dapi12392103129093021. Required if 'azureResourceId' is needed & not provided.
        </ParamField>

        <ParamField body="azureResourceId" type="String">
          The Azure Resource Manager ID for the Azure Databricks workspace. Required only if not doing token-based authentication.
        </ParamField>

        <ParamField body="catalog" type="String!" required>
          If using Unity Catalog, this is the catalog name. If not, this will be hive\_metastore
        </ParamField>

        <ParamField body="databricksSchema" type="String!" required>
          A logical collection of tables
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The name of the table or view
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="schema" type="TableImportSchemaInputType!" required>
      The schema for the CSV or Parquet files. The schema describes a mapping from your column names to model dimensions

      <Expandable title="TableImportSchemaInputType fields">
        <ParamField body="predictionId" type="String!" required>
          The name of the predictionId column in the file
        </ParamField>

        <ParamField body="predictionGroupId" type="String">
          The name of the predictionGroupId column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="features" type="String">
          A prefix capture group used to match feature columns
        </ParamField>

        <ParamField body="featuresList" type="[String!]">
          A list of column names specifying features
        </ParamField>

        <ParamField body="timestamp" type="String">
          The name of the timestamp column in the file
        </ParamField>

        <ParamField body="predictionLabel" type="String">
          The name of the prediction label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="predictionScore" type="String">
          The name of the prediction score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="predictionScores" type="String">
          The name of the prediction scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="actualLabel" type="String">
          The name of the actual label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="actualScore" type="String">
          The name of the actual score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="actualScores" type="String">
          The name of the actual scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="thresholdScores" type="String">
          The name of the threshold scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="relevanceLabel" type="String">
          The name of the relevance label column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="relevanceScore" type="String">
          The name of the relevance score column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="version" type="String">
          The name of the model version column in the file
        </ParamField>

        <ParamField body="batchId" type="String">
          The name of the validation batch id. Required if the model is type validation
        </ParamField>

        <ParamField body="tags" type="String">
          A prefix capture group used to match tag column
        </ParamField>

        <ParamField body="tagsList" type="[String!]">
          A list of column names specifying tags
        </ParamField>

        <ParamField body="shapValues" type="String">
          A regex like capture group that should be used to match shap column
        </ParamField>

        <ParamField body="rank" type="String">
          The name of the rank column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="exclude" type="[String!]">
          The names of fields to be excluded from data ingestion
        </ParamField>

        <ParamField body="embeddingFeatures" type="[FileImportEmbeddingInputType!]">
          The embedding fields that will be ingested

          <Expandable title="FileImportEmbeddingInputType fields">
            <ParamField body="featureName" type="String!" required>
              The embedding feature name
            </ParamField>

            <ParamField body="vectorCol" type="String!" required>
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String">
              The name of the raw data column
            </ParamField>

            <ParamField body="linkToDataCol" type="String">
              The name of the link to data column
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="prompt" type="FileImportPromptResponseInputType">
          The columns which contain the prompt used in a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="response" type="FileImportPromptResponseInputType">
          The columns which contain the response from a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="promptTemplate" type="FileImportPromptTemplateInputType">
          The columns which contain the prompt template fields, such as the template and template version. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptTemplateInputType fields">
            <ParamField body="template" type="String">
              The name of the column which contains the prompt template
            </ParamField>

            <ParamField body="templateVersion" type="String">
              The name of the column which contains the prompt template version
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="llmConfig" type="FileImportLlmConfigInputType">
          The columns which contain the llm config fields, such as the llm name and params. Relevant if the model is generative\_llm

          <Expandable title="FileImportLlmConfigInputType fields">
            <ParamField body="llmName" type="String">
              The name of the column which contains the llm name
            </ParamField>

            <ParamField body="llmParams" type="String">
              The name of the column which contains a map of llm params to values
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="runMetadata" type="FileImportRunMetadataInputType">
          The columns which contain the metadata relevant to the llm call that was used to generate the response using the prompt. Relevant if the model is generative\_llm

          <Expandable title="FileImportRunMetadataInputType fields">
            <ParamField body="totalTokenCount" type="String">
              The name of the column which contains the total number of tokens used in the llm call
            </ParamField>

            <ParamField body="promptTokenCount" type="String">
              The name of the column which contains the number of prompt tokens in the llm call
            </ParamField>

            <ParamField body="responseTokenCount" type="String">
              The name of the column which contains the number of response tokens in the llm call
            </ParamField>

            <ParamField body="responseLatencyMs" type="String">
              The name of the column which contains the response latency in ms of the llm call
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="predictionObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection prediction fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="actualObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection actual fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="changeTimestamp" type="String">
          The name of the change timestamp column in the file.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="dryRun" type="Boolean">
      If true, the import job will be attempted but no changes will be written. The fileResult field may be requested to check the validation status. Default is false
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="space" type="Space">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

<ResponseField name="validationResult" type="TableJobValidationResult">
  <Expandable title="TableJobValidationResult fields">
    Scalar fields: `jobId`, `tableQueryId`, `queryId`, `validationStatus`.

    Object fields (select subfields): `error`.
  </Expandable>
</ResponseField>

<ResponseField name="tableImportJob" type="TableImportJob">
  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateTableImportJob($input: CreateTableImportJobInput!) {
    createTableImportJob(input: $input) {
      space { id name }
      validationResult { jobId }
      tableImportJob { id }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "spaceId": "<ID>",
      "modelName": "<string>",
      "modelType": "numeric",
      "modelEnvironmentName": "production",
      "tableStore": "BigQuery",
      "schema": {
        "predictionId": "<string>"
      }
    }
  }
  ```
</CodeGroup>

### updateTableImportJob

Update an existing job that has been imported from a table

`updateTableImportJob(input: UpdateTableImportJobInput!): UpdateTableImportJobPayload`

#### Arguments

<ParamField body="input" type="UpdateTableImportJobInput!" required>
  <Expandable title="UpdateTableImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to delete
    </ParamField>

    <ParamField body="jobStatus" type="JobStatus">
      The status of the imported job One of: `ONGOING_INACTIVE`, `ONGOING_DELETED`.
    </ParamField>

    <ParamField body="modelVersion" type="String">
      The model version set as a constant
    </ParamField>

    <ParamField body="schema" type="TableImportSchemaInputType!" required>
      The schema describes a mapping from your column names to model dimensions

      <Expandable title="TableImportSchemaInputType fields">
        <ParamField body="predictionId" type="String!" required>
          The name of the predictionId column in the file
        </ParamField>

        <ParamField body="predictionGroupId" type="String">
          The name of the predictionGroupId column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="features" type="String">
          A prefix capture group used to match feature columns
        </ParamField>

        <ParamField body="featuresList" type="[String!]">
          A list of column names specifying features
        </ParamField>

        <ParamField body="timestamp" type="String">
          The name of the timestamp column in the file
        </ParamField>

        <ParamField body="predictionLabel" type="String">
          The name of the prediction label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="predictionScore" type="String">
          The name of the prediction score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="predictionScores" type="String">
          The name of the prediction scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="actualLabel" type="String">
          The name of the actual label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="actualScore" type="String">
          The name of the actual score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="actualScores" type="String">
          The name of the actual scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="thresholdScores" type="String">
          The name of the threshold scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="relevanceLabel" type="String">
          The name of the relevance label column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="relevanceScore" type="String">
          The name of the relevance score column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="version" type="String">
          The name of the model version column in the file
        </ParamField>

        <ParamField body="batchId" type="String">
          The name of the validation batch id. Required if the model is type validation
        </ParamField>

        <ParamField body="tags" type="String">
          A prefix capture group used to match tag column
        </ParamField>

        <ParamField body="tagsList" type="[String!]">
          A list of column names specifying tags
        </ParamField>

        <ParamField body="shapValues" type="String">
          A regex like capture group that should be used to match shap column
        </ParamField>

        <ParamField body="rank" type="String">
          The name of the rank column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="exclude" type="[String!]">
          The names of fields to be excluded from data ingestion
        </ParamField>

        <ParamField body="embeddingFeatures" type="[FileImportEmbeddingInputType!]">
          The embedding fields that will be ingested

          <Expandable title="FileImportEmbeddingInputType fields">
            <ParamField body="featureName" type="String!" required>
              The embedding feature name
            </ParamField>

            <ParamField body="vectorCol" type="String!" required>
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String">
              The name of the raw data column
            </ParamField>

            <ParamField body="linkToDataCol" type="String">
              The name of the link to data column
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="prompt" type="FileImportPromptResponseInputType">
          The columns which contain the prompt used in a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="response" type="FileImportPromptResponseInputType">
          The columns which contain the response from a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="promptTemplate" type="FileImportPromptTemplateInputType">
          The columns which contain the prompt template fields, such as the template and template version. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptTemplateInputType fields">
            <ParamField body="template" type="String">
              The name of the column which contains the prompt template
            </ParamField>

            <ParamField body="templateVersion" type="String">
              The name of the column which contains the prompt template version
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="llmConfig" type="FileImportLlmConfigInputType">
          The columns which contain the llm config fields, such as the llm name and params. Relevant if the model is generative\_llm

          <Expandable title="FileImportLlmConfigInputType fields">
            <ParamField body="llmName" type="String">
              The name of the column which contains the llm name
            </ParamField>

            <ParamField body="llmParams" type="String">
              The name of the column which contains a map of llm params to values
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="runMetadata" type="FileImportRunMetadataInputType">
          The columns which contain the metadata relevant to the llm call that was used to generate the response using the prompt. Relevant if the model is generative\_llm

          <Expandable title="FileImportRunMetadataInputType fields">
            <ParamField body="totalTokenCount" type="String">
              The name of the column which contains the total number of tokens used in the llm call
            </ParamField>

            <ParamField body="promptTokenCount" type="String">
              The name of the column which contains the number of prompt tokens in the llm call
            </ParamField>

            <ParamField body="responseTokenCount" type="String">
              The name of the column which contains the number of response tokens in the llm call
            </ParamField>

            <ParamField body="responseLatencyMs" type="String">
              The name of the column which contains the response latency in ms of the llm call
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="predictionObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection prediction fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="actualObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection actual fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="changeTimestamp" type="String">
          The name of the change timestamp column in the file.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="tableIngestionParameters" type="TableIngestionParametersInputType!" required>
      Table ingestion parameters

      <Expandable title="TableIngestionParametersInputType fields">
        <ParamField body="refreshIntervalMinutes" type="Int">
          How often a user wants to query data in minutes
        </ParamField>

        <ParamField body="queryWindowSizeHours" type="Int">
          How large of a query window to use in hours
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="tableImportJob" type="TableImportJob!">
  The updated table import job

  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation UpdateTableImportJob($input: UpdateTableImportJobInput!) {
    updateTableImportJob(input: $input) {
      tableImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>",
      "schema": {
        "predictionId": "<string>"
      },
      "tableIngestionParameters": {}
    }
  }
  ```
</CodeGroup>

### updateTableIngestionParameters

Update an existing job that has been imported from a table

`updateTableIngestionParameters(input: UpdateTableIngestionParametersInput!): UpdateTableIngestionParametersPayload`

#### Arguments

<ParamField body="input" type="UpdateTableIngestionParametersInput!" required>
  <Expandable title="UpdateTableIngestionParametersInput fields">
    <ParamField body="jobId" type="ID!" required>
      The import job id
    </ParamField>

    <ParamField body="tableIngestionParameters" type="TableIngestionParametersInputType!" required>
      Table ingestion parameters

      <Expandable title="TableIngestionParametersInputType fields">
        <ParamField body="refreshIntervalMinutes" type="Int">
          How often a user wants to query data in minutes
        </ParamField>

        <ParamField body="queryWindowSizeHours" type="Int">
          How large of a query window to use in hours
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="tableImportJob" type="TableImportJob!">
  The updated table import job

  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation UpdateTableIngestionParameters($input: UpdateTableIngestionParametersInput!) {
    updateTableIngestionParameters(input: $input) {
      tableImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>",
      "tableIngestionParameters": {}
    }
  }
  ```
</CodeGroup>

### startTableImportJob

Start an existing job that has been imported from a table

`startTableImportJob(input: StartTableImportJobInput!): StartTableImportJobPayload`

#### Arguments

<ParamField body="input" type="StartTableImportJobInput!" required>
  <Expandable title="StartTableImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to start
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="tableImportJob" type="FileImportJob!">
  The import job which has been started

  <Expandable title="FileImportJob fields">
    Scalar fields: `id`, `jobId`, `bucketName`, `createdAt`, `modelName`, `modelId`, `jobUuid`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `blobStore`, `prefix`, `totalFilesSuccessCount`, `totalFilesFailedCount`, `totalFilesPendingCount`, `jobStatus`.

    Object fields (select subfields): `schema`, `files`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation StartTableImportJob($input: StartTableImportJobInput!) {
    startTableImportJob(input: $input) {
      tableImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### pauseTableImportJob

Pause an existing job that has been imported from a table

`pauseTableImportJob(input: PauseTableImportJobInput!): PauseTableImportJobPayload`

#### Arguments

<ParamField body="input" type="PauseTableImportJobInput!" required>
  <Expandable title="PauseTableImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of an import job to pause
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="tableImportJob" type="TableImportJob!">
  The paused import job

  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation PauseTableImportJob($input: PauseTableImportJobInput!) {
    pauseTableImportJob(input: $input) {
      tableImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### deleteTableImportJob

Delete an existing job that has been imported from a table

`deleteTableImportJob(input: DeleteTableImportJobInput!): DeleteTableImportJobPayload`

#### Arguments

<ParamField body="input" type="DeleteTableImportJobInput!" required>
  <Expandable title="DeleteTableImportJobInput fields">
    <ParamField body="jobId" type="ID!" required>
      The ID of a table import job to delete
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="tableImportJob" type="TableImportJob!">
  The deleted table import job

  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

<ResponseField name="space" type="Space!">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation DeleteTableImportJob($input: DeleteTableImportJobInput!) {
    deleteTableImportJob(input: $input) {
      tableImportJob { id }
      space { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>"
    }
  }
  ```
</CodeGroup>

### createTriggeredOngoingTableImportJob

Create a job that will import model inferences from a table

`createTriggeredOngoingTableImportJob(input: CreateTriggeredOngoingTableImportJobInput!): CreateTriggeredOngoingTableImportJobPayload`

#### Arguments

<ParamField body="input" type="CreateTriggeredOngoingTableImportJobInput!" required>
  <Expandable title="CreateTriggeredOngoingTableImportJobInput fields">
    <ParamField body="spaceId" type="ID!" required>
      The space id for the space under which the model should be ingested
    </ParamField>

    <ParamField body="modelName" type="String!" required>
      The model identifier or name under which the model will be stored.
    </ParamField>

    <ParamField body="modelType" type="ModelType!" required>
      The type of model. This determines how the model will be analyzed One of: `numeric`, `score_categorical`, `ranking`, `object_detection`, `generative_llm`, `multi_class`.
    </ParamField>

    <ParamField body="modelEnvironmentName" type="ModelEnvironmentName!" required>
      The environment for which the inferences are being ingested One of: `production`, `validation`, `training`, `tracing`.
    </ParamField>

    <ParamField body="batchId" type="String">
      A name for the ingestion batch. Only required if the environment is validation
    </ParamField>

    <ParamField body="modelVersion" type="String">
      The model version. This will tag all the inferences as being for a specific version string.
    </ParamField>

    <ParamField body="tableStore" type="TableIntegrationType!" required>
      The table solution where the inferences reside One of: `BigQuery`, `Snowflake`, `Databricks`.
    </ParamField>

    <ParamField body="bigQueryTableConfig" type="BigQueryTableConfig">
      <Expandable title="BigQueryTableConfig fields">
        <ParamField body="projectId" type="String!" required>
          The unique string used to differentiate a Google Cloud project
        </ParamField>

        <ParamField body="dataset" type="String!" required>
          The dataset where the tables are stored. Arize must have access to this dataset
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The path to the table
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="snowflakeTableConfig" type="SnowflakeTableConfig">
      <Expandable title="SnowflakeTableConfig fields">
        <ParamField body="accountID" type="String!" required>
          The account identifier assigned to the Snowflake account.
        </ParamField>

        <ParamField body="schema" type="String!" required>
          The schema which the target Table belongs to. Together, a database and schema comprise a namespace in Snowflake.
        </ParamField>

        <ParamField body="database" type="String!" required>
          The database which the schema of the target Table belongs to.
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The table which to import data from.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="databricksTableConfig" type="DatabricksTableConfig">
      <Expandable title="DatabricksTableConfig fields">
        <ParamField body="hostname" type="String!" required>
          The base URL of the workspace ex. databricks-hostname-example.databricks.com
        </ParamField>

        <ParamField body="endpoint" type="String!" required>
          The URL fragment that corresponds to the resource, either a Compute Cluster or SQL Warehouse ex. /sql/1.0/warehouses/example
        </ParamField>

        <ParamField body="port" type="String!" required>
          The port of the resource ex. 443
        </ParamField>

        <ParamField body="token" type="String">
          Personal access token (for a service principal) ex. dapi12392103129093021. Required if 'azureResourceId' is needed & not provided.
        </ParamField>

        <ParamField body="azureResourceId" type="String">
          The Azure Resource Manager ID for the Azure Databricks workspace. Required only if not doing token-based authentication.
        </ParamField>

        <ParamField body="catalog" type="String!" required>
          If using Unity Catalog, this is the catalog name. If not, this will be hive\_metastore
        </ParamField>

        <ParamField body="databricksSchema" type="String!" required>
          A logical collection of tables
        </ParamField>

        <ParamField body="tableName" type="String!" required>
          The name of the table or view
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="schema" type="TableImportSchemaInputType!" required>
      The schema for the CSV or Parquet files. The schema describes a mapping from your column names to model dimensions

      <Expandable title="TableImportSchemaInputType fields">
        <ParamField body="predictionId" type="String!" required>
          The name of the predictionId column in the file
        </ParamField>

        <ParamField body="predictionGroupId" type="String">
          The name of the predictionGroupId column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="features" type="String">
          A prefix capture group used to match feature columns
        </ParamField>

        <ParamField body="featuresList" type="[String!]">
          A list of column names specifying features
        </ParamField>

        <ParamField body="timestamp" type="String">
          The name of the timestamp column in the file
        </ParamField>

        <ParamField body="predictionLabel" type="String">
          The name of the prediction label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="predictionScore" type="String">
          The name of the prediction score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="predictionScores" type="String">
          The name of the prediction scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="actualLabel" type="String">
          The name of the actual label column in the file. Supported on model of type score\_categorical
        </ParamField>

        <ParamField body="actualScore" type="String">
          The name of the actual score column in the file. Supported on models of type numeric and score\_categorical
        </ParamField>

        <ParamField body="actualScores" type="String">
          The name of the actual scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="thresholdScores" type="String">
          The name of the threshold scores column in the file. Supported on multi\_class models
        </ParamField>

        <ParamField body="relevanceLabel" type="String">
          The name of the relevance label column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="relevanceScore" type="String">
          The name of the relevance score column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="version" type="String">
          The name of the model version column in the file
        </ParamField>

        <ParamField body="batchId" type="String">
          The name of the validation batch id. Required if the model is type validation
        </ParamField>

        <ParamField body="tags" type="String">
          A prefix capture group used to match tag column
        </ParamField>

        <ParamField body="tagsList" type="[String!]">
          A list of column names specifying tags
        </ParamField>

        <ParamField body="shapValues" type="String">
          A regex like capture group that should be used to match shap column
        </ParamField>

        <ParamField body="rank" type="String">
          The name of the rank column in the file. Required if the model is type ranking
        </ParamField>

        <ParamField body="exclude" type="[String!]">
          The names of fields to be excluded from data ingestion
        </ParamField>

        <ParamField body="embeddingFeatures" type="[FileImportEmbeddingInputType!]">
          The embedding fields that will be ingested

          <Expandable title="FileImportEmbeddingInputType fields">
            <ParamField body="featureName" type="String!" required>
              The embedding feature name
            </ParamField>

            <ParamField body="vectorCol" type="String!" required>
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String">
              The name of the raw data column
            </ParamField>

            <ParamField body="linkToDataCol" type="String">
              The name of the link to data column
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="prompt" type="FileImportPromptResponseInputType">
          The columns which contain the prompt used in a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="response" type="FileImportPromptResponseInputType">
          The columns which contain the response from a generative LLM. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptResponseInputType fields">
            <ParamField body="vectorCol" type="String">
              The name of the vector column
            </ParamField>

            <ParamField body="rawDataCol" type="String!" required>
              The name of the raw data column. Required if the prompt or response is specified
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="promptTemplate" type="FileImportPromptTemplateInputType">
          The columns which contain the prompt template fields, such as the template and template version. Relevant if the model is generative\_llm

          <Expandable title="FileImportPromptTemplateInputType fields">
            <ParamField body="template" type="String">
              The name of the column which contains the prompt template
            </ParamField>

            <ParamField body="templateVersion" type="String">
              The name of the column which contains the prompt template version
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="llmConfig" type="FileImportLlmConfigInputType">
          The columns which contain the llm config fields, such as the llm name and params. Relevant if the model is generative\_llm

          <Expandable title="FileImportLlmConfigInputType fields">
            <ParamField body="llmName" type="String">
              The name of the column which contains the llm name
            </ParamField>

            <ParamField body="llmParams" type="String">
              The name of the column which contains a map of llm params to values
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="runMetadata" type="FileImportRunMetadataInputType">
          The columns which contain the metadata relevant to the llm call that was used to generate the response using the prompt. Relevant if the model is generative\_llm

          <Expandable title="FileImportRunMetadataInputType fields">
            <ParamField body="totalTokenCount" type="String">
              The name of the column which contains the total number of tokens used in the llm call
            </ParamField>

            <ParamField body="promptTokenCount" type="String">
              The name of the column which contains the number of prompt tokens in the llm call
            </ParamField>

            <ParamField body="responseTokenCount" type="String">
              The name of the column which contains the number of response tokens in the llm call
            </ParamField>

            <ParamField body="responseLatencyMs" type="String">
              The name of the column which contains the response latency in ms of the llm call
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="predictionObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection prediction fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="actualObjectDetectionLabel" type="FileImportObjectDetectionLabelInputType">
          The columns which contain the object detection actual fields, such as the bounding box coordinates, categories, and scores. Relevant if the model is object\_detection

          <Expandable title="FileImportObjectDetectionLabelInputType fields">
            <ParamField body="boundingBoxesCoordinatesColumnName" type="String!" required>
              The name of the column which contains the bounding box coordinates
            </ParamField>

            <ParamField body="boundingBoxesCategoriesColumnName" type="String!" required>
              The name of the column which contains a map of bounding box categories
            </ParamField>

            <ParamField body="boundingBoxesScoresColumnName" type="String">
              The name of the column which contains a map of bounding box scores
            </ParamField>
          </Expandable>
        </ParamField>

        <ParamField body="changeTimestamp" type="String">
          The name of the change timestamp column in the file.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="space" type="Space">
  <Expandable title="Space fields">
    Scalar fields: `id`, `name`, `description`, `uuid`, `createdAt`, `liveEnabled`, `isLLMOnlySpace`, `playgroundTracingModelId`, `evalTracingModelId`, `sandboxTracingModelId`, `mlModelsEnabled`, `private`, `gradientStartColor`, `gradientEndColor`, `hasDashboardsCreated`.

    Object fields (select subfields): `organization`, `models`, `monitors`, `dashboards`, `spaceUsers`, `byobConnectors`, `importJobs`, `tableJobs`, `sandboxJobs`, `signalInsightSummary`, `signalEnabledProjectSummary`, `signalIssues`, `agentIssues`, `automations`, `datasets`, `experiments`, `customMetrics`, `onlineTasks`, `prompts`, `tags`, `evaluators`, `annotationQueues`, `playgroundViews`, `annotationConfigs`, `traceFilters`, `llmIntegrations`, `defaultLlmIntegration`, `defaultAgentRuntime`, `gates`, `_access`.
  </Expandable>
</ResponseField>

<ResponseField name="validationResult" type="TableJobValidationResult">
  <Expandable title="TableJobValidationResult fields">
    Scalar fields: `jobId`, `tableQueryId`, `queryId`, `validationStatus`.

    Object fields (select subfields): `error`.
  </Expandable>
</ResponseField>

<ResponseField name="tableImportJob" type="TableImportJob">
  <Expandable title="TableImportJob fields">
    Scalar fields: `id`, `jobId`, `jobStatus`, `tableStore`, `projectId`, `dataset`, `createdAt`, `modelName`, `modelId`, `modelType`, `modelVersion`, `modelEnvironmentName`, `batchId`, `table`, `totalQueriesSuccessCount`, `totalQueriesFailedCount`, `totalQueriesPendingCount`.

    Object fields (select subfields): `schema`, `tableIngestionParameters`, `queries`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateTriggeredOngoingTableImportJob($input: CreateTriggeredOngoingTableImportJobInput!) {
    createTriggeredOngoingTableImportJob(input: $input) {
      space { id name }
      validationResult { jobId }
      tableImportJob { id }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "spaceId": "<ID>",
      "modelName": "<string>",
      "modelType": "numeric",
      "modelEnvironmentName": "production",
      "tableStore": "BigQuery",
      "schema": {
        "predictionId": "<string>"
      }
    }
  }
  ```
</CodeGroup>

### createTriggeredOngoingTableRun

Schedule a job run that will import model inferences from a table

`createTriggeredOngoingTableRun(input: CreateTriggeredOngoingTableRunInput!): CreateTriggeredOngoingTableRunPayload`

#### Arguments

<ParamField body="input" type="CreateTriggeredOngoingTableRunInput!" required>
  <Expandable title="CreateTriggeredOngoingTableRunInput fields">
    <ParamField body="jobId" type="ID!" required>
      The job id to schedule a table ingestion run for
    </ParamField>

    <ParamField body="queryStart" type="DateTime!" required>
      The start time for the query
    </ParamField>

    <ParamField body="queryEnd" type="DateTime!" required>
      The end time for the query
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateTriggeredOngoingTableRun($input: CreateTriggeredOngoingTableRunInput!) {
    createTriggeredOngoingTableRun(input: $input) {
      clientMutationId
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "jobId": "<ID>",
      "queryStart": "2026-01-01T00:00:00Z",
      "queryEnd": "2026-01-01T00:00:00Z"
    }
  }
  ```
</CodeGroup>

### createIntegrationKey

`createIntegrationKey(input: CreateIntegrationKeyInput!): CreateIntegrationKeyPayload`

#### Arguments

<ParamField body="input" type="CreateIntegrationKeyInput!" required>
  <Expandable title="CreateIntegrationKeyInput fields">
    <ParamField body="accountOrganizationId" type="ID!" required>
      The global relay id of the organization to create the integration key in.
    </ParamField>

    <ParamField body="providerName" type="IntegrationProvider!" required>
      The name of an integration provider e.g. opsgeneie, pagerduty, slack One of: `opsgenie`, `pagerduty`, `slack`.
    </ParamField>

    <ParamField body="serviceName" type="String!" required>
      The name of the integration, used to denote a target service or team e.x. ML Team Opsgenie.
    </ParamField>

    <ParamField body="apiKey" type="String!" required>
      The integration's api key
    </ParamField>

    <ParamField body="alertSeverity" type="IntegrationAlertSeverity">
      The priority/severity level when sending alerts to the given integration provider. One of: `opsgenieP1`, `opsgenieP2`, `opsgenieP3`, `opsgenieP4`, `opsgenieP5`, `pagerdutycritical`, `pagerdutyerror`, `pagerdutywarning`, `pagerdutyinfo`.
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="integrationKey" type="IntegrationKey!">
  The created integration key.

  <Expandable title="IntegrationKey fields">
    Scalar fields: `id`, `name`, `providerName`, `createdAt`, `alertSeverity`, `channelName`.

    Object fields (select subfields): `creator`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateIntegrationKey($input: CreateIntegrationKeyInput!) {
    createIntegrationKey(input: $input) {
      integrationKey { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "accountOrganizationId": "<ID>",
      "providerName": "opsgenie",
      "serviceName": "<string>",
      "apiKey": "<string>"
    }
  }
  ```
</CodeGroup>

### patchIntegrationKey

`patchIntegrationKey(input: PatchIntegrationKeyInput!): PatchIntegrationKeyPayload`

#### Arguments

<ParamField body="input" type="PatchIntegrationKeyInput!" required>
  <Expandable title="PatchIntegrationKeyInput fields">
    <ParamField body="integrationKeyId" type="ID!" required>
      The ID of the integration to patch
    </ParamField>

    <ParamField body="set" type="IntegrationKeyPatchInput!" required>
      Patch of the integration

      <Expandable title="IntegrationKeyPatchInput fields">
        <ParamField body="serviceName" type="String">
          The name of the integration, used to denote a target service or team e.x. ML Team Opsgenie.
        </ParamField>

        <ParamField body="apiKey" type="String">
          The integration's api key
        </ParamField>

        <ParamField body="alertSeverity" type="IntegrationAlertSeverity">
          The priority/severity level when sending alerts to the given integration provider. One of: `opsgenieP1`, `opsgenieP2`, `opsgenieP3`, `opsgenieP4`, `opsgenieP5`, `pagerdutycritical`, `pagerdutyerror`, `pagerdutywarning`, `pagerdutyinfo`.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="integrationKey" type="IntegrationKey!">
  The updated integration.

  <Expandable title="IntegrationKey fields">
    Scalar fields: `id`, `name`, `providerName`, `createdAt`, `alertSeverity`, `channelName`.

    Object fields (select subfields): `creator`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation PatchIntegrationKey($input: PatchIntegrationKeyInput!) {
    patchIntegrationKey(input: $input) {
      integrationKey { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "integrationKeyId": "<ID>",
      "set": {}
    }
  }
  ```
</CodeGroup>

### testIntegrationKey

`testIntegrationKey(input: TestIntegrationKeyInput!): TestIntegrationKeyPayload`

#### Arguments

<ParamField body="input" type="TestIntegrationKeyInput!" required>
  <Expandable title="TestIntegrationKeyInput fields">
    <ParamField body="integrationKeyId" type="ID!" required>
      The global relay id for the integration key to update
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="statusCode" type="Int!">
  The http status code of the test integration endpoint response e.g. 201, 401, etc
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation TestIntegrationKey($input: TestIntegrationKeyInput!) {
    testIntegrationKey(input: $input) {
      statusCode
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "integrationKeyId": "<ID>"
    }
  }
  ```
</CodeGroup>

### deleteIntegrationKey

`deleteIntegrationKey(input: DeleteIntegrationKeyInput!): DeleteIntegrationKeyPayload`

#### Arguments

<ParamField body="input" type="DeleteIntegrationKeyInput!" required>
  <Expandable title="DeleteIntegrationKeyInput fields">
    <ParamField body="integrationKeyId" type="ID!" required>
      The global relay id for the integration key to delete
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="integrationKey" type="IntegrationKey!">
  The soft deleted integration key.

  <Expandable title="IntegrationKey fields">
    Scalar fields: `id`, `name`, `providerName`, `createdAt`, `alertSeverity`, `channelName`.

    Object fields (select subfields): `creator`.
  </Expandable>
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation DeleteIntegrationKey($input: DeleteIntegrationKeyInput!) {
    deleteIntegrationKey(input: $input) {
      integrationKey { id name }
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "integrationKeyId": "<ID>"
    }
  }
  ```
</CodeGroup>

### validateByobConnector

Validate a byob connector

`validateByobConnector(input: ValidateByobConnectorInput!): ValidateByobConnectorPayload`

#### Arguments

<ParamField body="input" type="ValidateByobConnectorInput!" required>
  <Expandable title="ValidateByobConnectorInput fields">
    <ParamField body="spaceId" type="ID!" required>
      The id of the space that the byob connector belongs to
    </ParamField>

    <ParamField body="connectorIdentifier" type="ByobConnectorIdentifier!" required>
      The object that identifies the byob connector

      <Expandable title="ByobConnectorIdentifier fields">
        <ParamField body="spaceId" type="ID!" required>
          The id of the space that the byob connector belongs to
        </ParamField>

        <ParamField body="cloudStorageProvider" type="CloudStorageProvider!" required>
          The cloud storage provider that the byob connector belongs to One of: `GCS`, `S3`, `AZURE`.
        </ParamField>

        <ParamField body="bucketAndPath" type="String!" required>
          The full path of the bucket that the byob connector belongs to
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="azureTenantId" type="String">
      The Azure tenant ID for Azure Blob Storage connectors
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="isValid" type="Boolean!">
  Whether the byob connector is valid
</ResponseField>

<ResponseField name="validationReason" type="ValidationReason">
  The reason why the byob connector is valid One of: `UNKNOWN_INVALID_REASON`, `FAILED_BUCKET_OWNERSHIP_CHECK`, `FAILED_BUCKET_ACCESS`.
</ResponseField>

<ResponseField name="validationMessage" type="String">
  The message that explains why the byob connector is valid
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation ValidateByobConnector($input: ValidateByobConnectorInput!) {
    validateByobConnector(input: $input) {
      isValid
      validationReason
      validationMessage
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "spaceId": "<ID>",
      "connectorIdentifier": {
        "spaceId": "<ID>",
        "cloudStorageProvider": "GCS",
        "bucketAndPath": "<string>"
      }
    }
  }
  ```
</CodeGroup>

### createByobConnector

Create a byob connector

`createByobConnector(input: CreateByobConnectorInput!): CreateByobConnectorPayload`

#### Arguments

<ParamField body="input" type="CreateByobConnectorInput!" required>
  <Expandable title="CreateByobConnectorInput fields">
    <ParamField body="spaceId" type="ID!" required>
      The id of the space that the byob connector belongs to
    </ParamField>

    <ParamField body="connectorIdentifier" type="ByobConnectorIdentifier!" required>
      The identifier of the byob connector

      <Expandable title="ByobConnectorIdentifier fields">
        <ParamField body="spaceId" type="ID!" required>
          The id of the space that the byob connector belongs to
        </ParamField>

        <ParamField body="cloudStorageProvider" type="CloudStorageProvider!" required>
          The cloud storage provider that the byob connector belongs to One of: `GCS`, `S3`, `AZURE`.
        </ParamField>

        <ParamField body="bucketAndPath" type="String!" required>
          The full path of the bucket that the byob connector belongs to
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="name" type="String!" required>
      The name of the byob connector
    </ParamField>

    <ParamField body="externalModelIds" type="[String]!" required>
      The external model ids of the byob connector
    </ParamField>

    <ParamField body="tableFormat" type="ByobTableFormat">
      The table format for the connector (defaults to ICEBERG) One of: `ICEBERG`, `DELTA`.
    </ParamField>

    <ParamField body="azureTenantId" type="String">
      The Azure tenant ID for Azure Blob Storage connectors
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="id" type="ID!">
  The id of the created byob connector
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation CreateByobConnector($input: CreateByobConnectorInput!) {
    createByobConnector(input: $input) {
      id
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "spaceId": "<ID>",
      "connectorIdentifier": {
        "spaceId": "<ID>",
        "cloudStorageProvider": "GCS",
        "bucketAndPath": "<string>"
      },
      "name": "<string>",
      "externalModelIds": [
        "<string>"
      ]
    }
  }
  ```
</CodeGroup>

### updateByobConnector

Update a byob connector

`updateByobConnector(input: UpdateByobConnectorInput!): UpdateByobConnectorPayload`

#### Arguments

<ParamField body="input" type="UpdateByobConnectorInput!" required>
  <Expandable title="UpdateByobConnectorInput fields">
    <ParamField body="id" type="ID!" required>
      The id of the byob connector
    </ParamField>

    <ParamField body="spaceId" type="ID!" required>
      The id of the space that the byob connector belongs to
    </ParamField>

    <ParamField body="name" type="String!" required>
      The name of the byob connector
    </ParamField>

    <ParamField body="externalModelIds" type="[String]!" required>
      The external model ids of the byob connector
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="success" type="Boolean">
  Whether the update was successful
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation UpdateByobConnector($input: UpdateByobConnectorInput!) {
    updateByobConnector(input: $input) {
      success
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "id": "<ID>",
      "spaceId": "<ID>",
      "name": "<string>",
      "externalModelIds": [
        "<string>"
      ]
    }
  }
  ```
</CodeGroup>

### deleteByobConnector

Delete a byob connector

`deleteByobConnector(input: DeleteByobConnectorInput!): DeleteByobConnectorPayload`

#### Arguments

<ParamField body="input" type="DeleteByobConnectorInput!" required>
  <Expandable title="DeleteByobConnectorInput fields">
    <ParamField body="id" type="ID!" required>
      The id of the byob connector
    </ParamField>

    <ParamField body="spaceId" type="ID!" required>
      The id of the space that the byob connector belongs to
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="success" type="Boolean">
  Whether the delete was successful
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation DeleteByobConnector($input: DeleteByobConnectorInput!) {
    deleteByobConnector(input: $input) {
      success
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "id": "<ID>",
      "spaceId": "<ID>"
    }
  }
  ```
</CodeGroup>

### updateByobSyncedDatasource

Update a byob synced datasource

`updateByobSyncedDatasource(input: UpdateByobSyncedDatasourceInput!): UpdateByobSyncedDatasourcePayload`

#### Arguments

<ParamField body="input" type="UpdateByobSyncedDatasourceInput!" required>
  <Expandable title="UpdateByobSyncedDatasourceInput fields">
    <ParamField body="id" type="ID!" required>
      The id of the byob synced datasource
    </ParamField>

    <ParamField body="spaceId" type="ID!" required>
      The id of the space
    </ParamField>

    <ParamField body="activeStatus" type="ActiveStatus">
      The active status of the byob synced datasource One of: `active`, `paused`.
    </ParamField>

    <ParamField body="syncFrequencyMinutes" type="Int">
      The sync frequency minutes of the byob synced datasource
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="success" type="Boolean">
  Whether the update was successful
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation UpdateByobSyncedDatasource($input: UpdateByobSyncedDatasourceInput!) {
    updateByobSyncedDatasource(input: $input) {
      success
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "id": "<ID>",
      "spaceId": "<ID>"
    }
  }
  ```
</CodeGroup>

### deleteByobDatasource

Delete a byob datasource

`deleteByobDatasource(input: DeleteByobDatasourceInput!): DeleteByobDatasourcePayload`

#### Arguments

<ParamField body="input" type="DeleteByobDatasourceInput!" required>
  <Expandable title="DeleteByobDatasourceInput fields">
    <ParamField body="id" type="ID!" required>
      The id of the byob datasource
    </ParamField>

    <ParamField body="spaceId" type="ID!" required>
      The id of the space that the byob datasource belongs to
    </ParamField>

    <ParamField body="clientMutationId" type="String" />
  </Expandable>
</ParamField>

#### Returns

<ResponseField name="success" type="Boolean">
  Whether the delete was successful
</ResponseField>

#### Example

Only required input fields are shown. Replace `<ID>` and `<string>` placeholders with real values; the [object graph](/docs/ax/graphql-reference/queries/object-graph) page shows how to look IDs up.

<CodeGroup>
  ```graphql Mutation theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  mutation DeleteByobDatasource($input: DeleteByobDatasourceInput!) {
    deleteByobDatasource(input: $input) {
      success
    }
  }
  ```

  ```json Variables theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  {
    "input": {
      "id": "<ID>",
      "spaceId": "<ID>"
    }
  }
  ```
</CodeGroup>
