get_import

string

Deep link to this import in the Qobra web app. Null for an import no history page lists: a legacy one whose batches name no resource type.

string

Overall status. One of: scheduled, started, finished.

string

What kicked the import off, e.g. ‘scheduled_refresh’. Null when unknown. One of: scheduled_refresh, integration_refresh, integrations_with_frequency_refresh, braqoffice_refresh, users_creation, user_integration_sync, user_file_import_refresh, user_attributes_creation, user_attribute_sync, groups_creation, data_table_refresh, data_table_settings_update, field_creation, quota_creation, quota_sync, quota_refresh, quota_settings_update.

integer

Completion from 0 to 1, averaged across the batches (1 with none).

boolean

True when a batch you can read ended in error (get_import says which).

boolean

True when a batch you can read rejected or skipped some rows (get_import lists them), even without an error.

string[]

Distinct resource types the import touched.

object

The user who triggered the import; null for a system or scheduled import.

Show object properties

string

object[]

One entry per resource batch. Only the batches of resource types you can read are listed.

Show object properties

string

How the data reached Qobra: ‘integration’ (a connector sync), ‘api’ (a push), ‘csv’ (a file upload), ‘references’ or ‘bulk_action’. One of: integration, api, csv, references, bulk_action.

string

What this batch imported into. One of: data_table, quota, user.

string

Id of the data table or quota; null for a company-wide user import.

object

The connection this batch synced from (one run can bundle several). Null for a CSV upload, a bulk action, an API push tied to no connection or a removed connection.

Show object properties

string

One of: kombo, salesforce, pipedrive, microsoft_dynamics, hubspot, odoo, zoho, attio, postgresql, gcp-postgresql, snowflake, snowflake-keys, redshift, microsoft-azure-sql, microsoft-azure-synapse, bigquery, s3, sftp, netsuite, public_api.

string

Batch status. One of: scheduled, started, finished.

number

Completion of this batch, from 0 to 1.

string

boolean

True when this batch ended in error.

string

Why the batch failed. Integration side: ‘authentication’ (credentials rejected, reconnect it), ‘permission’ (the account lacks access), ‘configuration’ (a setting, query or object is wrong or missing), ‘rate_limit’ (retry later), ‘unavailable’ (the integration is down or answered unreadably), ‘invalid_request’ (it rejected the request), ‘unknown’. Qobra side: ‘internal’ (not the customer’s to fix), ‘validation’ (pushed rows were rejected, the description lists why), ‘invalid_config’ (a Qobra bug on the batch setup), ‘cancelled’ (stopped on Qobra’s side). Null on an error recorded before categories existed.

boolean

True when the batch rejected or skipped some rows (see rejected_rows), even without an error.

string

What the batch did within its resource_type: for a user import the part it imported (users-attributes, hierarchy (who manages whom), groups (memberships), provisioning), for a bulk action its action. Null for any other batch.

integer

How many rejections the batch kept: one per rejected row, except a record_range, which stands for a whole chunk of records. It keeps the last 100 only. For the number of records not applied, read number_of_records_skipped.

boolean

True when the batch reached the 100 rejections kept: there may be more.

object[]

The first 5 rejections kept, in recorded order (rejected lines first, then a user import’s attribute errors), each with its reason. The import’s resource_url opens the page listing the rest of the rejected lines; the attribute errors past these are counted in rejected_row_count and listed nowhere else. When rejected_rows_truncated is true, older ones were already dropped. The row’s own source values are never included.

Show object properties

object

What was rejected, by kind: ‘line’ (a CSV line or an API payload record, by position), ‘user’ (a user attribute error, or a user a bulk action failed on), ‘group’ or ‘record’ (one a bulk action failed on), ‘record_range’ (a whole chunk of records a bulk action failed on). Null when nothing locates the row (a quota row).

Show LineLocator properties

string

Always line.

integer

Line of the CSV file, or position of the record in an API payload, counted from 1.

Show UserLocator properties

string

Always user.

string

Id of the user the rejection is about, always set.

object

That user, or null when no user has that id any more — typically a bulk action reporting it not found.

Show object properties

string

Key of the user field an attribute error is on. Null when the rejection is about the user as a whole.

Show GroupLocator properties

string

Always group.

object

The group a bulk action failed on.

Show object properties

string

Show RecordLocator properties

string

Always record.

string

Id of the record a data-table bulk action failed on, in the table the batch’s resource_id names.

Show RecordRangeLocator properties

string

Always record_range.

string

Id of the first record of the chunk that failed.

string

Id of the last record of that chunk: the failure covers every selected record between the two, in the table the batch’s resource_id names.

string

Why the row was rejected or skipped, as the import recorded it, cut at 500 characters (ending with ’…’ when cut). Null when it recorded none.

integer

Total records processed by this batch, when tracked.

integer

Qobra MCP server

Parameters

Response

​Parameters

​Response

Parameters

Response