atmon docs

REFERENCE/TOOLKITS/ALGOLIA_INGESTION.MD

Algolia Ingestion

Feeding a search index. Push records in, run and watch import tasks, and manage the sources and transformations behind them.

PropertyValue
Slugalgolia_ingestion
Definition version0.1.0
Base URLhttps://data.us.algolia.com
Auth schemesapi_key
Action tools56
By class17 read, 33 write, 6 destructive
Triggers0
Provider rate limitnot declared, so outbound calls are unpaced

Measured routing accuracy

69 golden cases replayed through the router over the whole index: measured over corpus ea4f12ad2948 (65 toolkits, 2283 tools indexed and 13 declared uncallable), 56 cases written by hand and 13 cases from the paraphrase pass. A case counts as top-1 when its gold tool ranked first and top-8 when it reached the slate at all.

MeasureCasesShare
top-147/6968.1%
top-865/6994.2%

The sweep is offline: the reranker is a deterministic identity fake that returns candidates in the order retrieval produced them, so top-1 measures retrieval order rather than a reranked slate. just eval-live measures the same cases through the live reranker.

Authentication

Connect an entity with ConnectionsService.InitiateConnection, naming this toolkit's slug. Credentials stay in the connections vault; callers hold connected-account ids only.

api_key

PropertyValue
Placementheader
Namex-algolia-api-key
Rendered as{key}

Submit the key with ConnectionsService rather than putting it in a request; it is sealed at rest and never returned.

Tools

56 action tools. The catalog-wide slug is algolia_ingestion.<tool>, which is what search_tools returns and call_tool takes.

algolia_ingestion.list_authentications

List the Algolia ingestion authentication resources: the saved credentials and login secrets used to connect the pipeline to external systems and providers. Calls GET /1/authentications.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/authentications.

Arguments:

ArgumentTypeRequiredNotes
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
platformarray of stringnoEcommerce platform for which to retrieve authentications.
sortstring, one of name, type, platform, updatedAt, createdAtnoProperty by which to sort the list of authentications. Defaults to createdAt.
typearray of stringnoType of authentication resource to retrieve.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationsarray of object
authentications[].authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
authentications[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
authentications[].inputobjectCredentials for authenticating with a Google service account, such as BigQuery.
authentications[].namestringDescriptive name for the resource.
authentications[].ownerstringOwner of the resource.
authentications[].platformstring, one of bigcommerce, commercetools, shopifyName of an ecommerce platform with which to authenticate. This determines which authentication type you can select.
authentications[].typestring, one of googleServiceAccount, basic, apiKey, oauth, algolia, algoliaInsights, secretsType of authentication. This determines the type of credentials required in the input object.
authentications[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.

Also retrieved by: "show the saved credentials for connecting to systems", "list the login secrets the pipeline uses", "which providers do we have credentials for".

algolia_ingestion.create_authentication

Create an Algolia ingestion authentication resource: save a new set of credentials or login secret so the pipeline can connect to an external system. Calls POST /1/authentications.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/authentications.

Arguments:

ArgumentTypeRequiredNotes
inputobjectyesCredentials for authenticating with a Google service account, such as BigQuery.
input.clientEmailstringyesEmail address of the Google service account.
input.privateKeystringyesPrivate key of the Google service account. This field is null in the API response.
namestringyesDescriptive name for the resource.
platformstring, one of bigcommerce, commercetools, shopifynoName of an ecommerce platform with which to authenticate. This determines which authentication type you can select.
typestring, one of googleServiceAccount, basic, apiKey, oauth, algolia, algoliaInsights, secretsyesType of authentication. This determines the type of credentials required in the input object.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
namestringDescriptive name for the resource.

Also retrieved by: "save credentials for reaching a system", "store a new login secret for a provider", "add connection credentials for the pipeline".

algolia_ingestion.search_authentications

Search the Algolia ingestion authentication resources: filter the saved credentials and connection secrets by name, platform, or type instead of paging the whole list. Calls POST /1/authentications/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/authentications/search.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDsarray of stringyes

Also retrieved by: "find a saved credential by name", "filter connection secrets by platform", "which credentials match this provider".

algolia_ingestion.get_authentication

Get one Algolia ingestion authentication resource by its id: the saved credential used to connect to an external system, without its secret. Calls GET /1/authentications/{authenticationID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/authentications/{{params.authenticationID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringyesUnique identifier of an authentication resource.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
inputobjectCredentials for authenticating with a Google service account, such as BigQuery.
input.clientEmailstringEmail address of the Google service account.
input.privateKeystringPrivate key of the Google service account. This field is null in the API response.
namestringDescriptive name for the resource.
ownerstringOwner of the resource.
platformstring, one of bigcommerce, commercetools, shopifyName of an ecommerce platform with which to authenticate. This determines which authentication type you can select.
typestring, one of googleServiceAccount, basic, apiKey, oauth, algolia, algoliaInsights, secretsType of authentication. This determines the type of credentials required in the input object.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "pull up one saved credential by id", "show a single stored connection secret", "fetch the details of one credential".

algolia_ingestion.update_authentication

Update an Algolia ingestion authentication resource: change the stored credential's name, platform, or secret so the pipeline connects with new details. Calls PATCH /1/authentications/{authenticationID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PATCH /1/authentications/{{params.authenticationID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringyesUnique identifier of an authentication resource.
inputobjectnoCredentials for authenticating with a Google service account, such as BigQuery.
input.clientEmailstringnoEmail address of the Google service account.
input.privateKeystringnoPrivate key of the Google service account. This field is null in the API response.
namestringnoDescriptive name for the resource.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
namestringDescriptive name for the resource.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "rotate the secret on a stored credential", "change how the pipeline logs in to a system", "fix the credential details for a provider".

algolia_ingestion.delete_authentication

Delete an Algolia ingestion authentication resource: remove a stored credential the pipeline no longer uses to connect to a system. Calls DELETE /1/authentications/{authenticationID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /1/authentications/{{params.authenticationID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringyesUnique identifier of an authentication resource.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "remove a stored credential we no longer use", "drop a saved connection secret", "delete an unused provider credential".

algolia_ingestion.list_destinations

List the Algolia ingestion destinations: the target indices and places where imported and ingested data is written at the end of the pipeline. Calls GET /1/destinations.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/destinations.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDarray of stringnoAuthentication ID used by destinations.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of name, type, updatedAt, createdAtnoProperty by which to sort the destinations. Defaults to createdAt.
transformationIDstringnoGet the list of destinations used by a transformation.
typearray of stringnoDestination type.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
destinationsarray of object
destinations[].authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
destinations[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
destinations[].destinationIDstringUniversally unique identifier (UUID) of a destination resource.
destinations[].inputobject
destinations[].namestringDescriptive name for the resource.
destinations[].ownerstringOwner of the resource.
destinations[].transformationIDsarray
destinations[].typestring, one of search, insightsDestination type. - search. Data is stored in an Algolia index. - insights. Data is recorded as user events in the Insights API.
destinations[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.

Also retrieved by: "where does ingested data get written", "show the target indices data lands in", "list the write targets of the pipeline".

algolia_ingestion.create_destination

Create an Algolia ingestion destination: define a new target index or place to write imported records into at the end of the pipeline. Calls POST /1/destinations.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/destinations.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
inputobjectyes
input.attributesToExcludearraynoAttributes from your source to exclude from Algolia records. Not all your data attributes will be useful for searching. Keeping your Algolia records small increases indexing and search performance. -...
input.indexNamestringyesAlgolia index name (case-sensitive).
input.recordTypestring, one of product, variant, collectionnoRecord type for ecommerce sources.
namestringyesDescriptive name for the resource.
transformationIDsarray of stringno
typestring, one of search, insightsyesDestination type. - search. Data is stored in an Algolia index. - insights. Data is recorded as user events in the Insights API.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
destinationIDstringUniversally unique identifier (UUID) of a destination resource.
namestringDescriptive name for the resource.

Also retrieved by: "define a new place to write records into", "add a target index for imported data", "set up where the pipeline writes".

algolia_ingestion.search_destinations

Search the Algolia ingestion destinations: filter the target indices data is written into by name or type instead of paging the whole list. Calls POST /1/destinations/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/destinations/search.

Arguments:

ArgumentTypeRequiredNotes
destinationIDsarray of stringyes

Also retrieved by: "find the target index by name", "which write targets match this filter", "filter the places records land in".

algolia_ingestion.get_destination

Get one Algolia ingestion destination by its id: the target index records are written into at the end of the pipeline, and how it is configured. Calls GET /1/destinations/{destinationID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/destinations/{{params.destinationID}}.

Arguments:

ArgumentTypeRequiredNotes
destinationIDstringyesUnique identifier of a destination.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
destinationIDstringUniversally unique identifier (UUID) of a destination resource.
inputobject
input.attributesToExcludearrayAttributes from your source to exclude from Algolia records. Not all your data attributes will be useful for searching. Keeping your Algolia records small increases indexing and search performance. -...
input.indexNamestringAlgolia index name (case-sensitive).
input.recordTypestring, one of product, variant, collectionRecord type for ecommerce sources.
namestringDescriptive name for the resource.
ownerstringOwner of the resource.
transformationIDsarray of string
typestring, one of search, insightsDestination type. - search. Data is stored in an Algolia index. - insights. Data is recorded as user events in the Insights API.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "show one write target by id", "what index does this target write to", "details of a single ingestion output".

algolia_ingestion.update_destination

Update an Algolia ingestion destination: point it at a different target index or change how imported records are written at the end of the pipeline. Calls PATCH /1/destinations/{destinationID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PATCH /1/destinations/{{params.destinationID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
destinationIDstringyesUnique identifier of a destination.
inputobjectno
input.attributesToExcludearraynoAttributes from your source to exclude from Algolia records. Not all your data attributes will be useful for searching. Keeping your Algolia records small increases indexing and search performance. -...
input.indexNamestringnoAlgolia index name (case-sensitive).
input.recordTypestring, one of product, variant, collectionnoRecord type for ecommerce sources.
namestringnoDescriptive name for the resource.
transformationIDsarray of stringno

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
destinationIDstringUniversally unique identifier (UUID) of a destination resource.
namestringDescriptive name for the resource.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "point the pipeline at a different index", "change where imported records are written", "edit the output settings of a write target".

algolia_ingestion.delete_destination

Delete an Algolia ingestion destination: stop writing imported records into that target index and remove it from the pipeline. Calls DELETE /1/destinations/{destinationID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /1/destinations/{{params.destinationID}}.

Arguments:

ArgumentTypeRequiredNotes
destinationIDstringyesUnique identifier of a destination.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "stop writing records into this index", "remove a write target from the pipeline", "drop an output we no longer load into".

algolia_ingestion.push

Push records straight into an Algolia index through the ingestion pipeline: send a batch of documents to be transformed and indexed without configuring a source first. Calls POST /1/push/{indexName}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/push/{{params.indexName}}.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject, delete, clearyesWhich indexing operation to perform: - addObject: adds records to an index. Equivalent to the "Add a new record (with auto-generated object ID)" operation. - updateObject: adds or replaces...
indexNamestringyesName of the index on which to perform the operation.
recordsarray of objectyes
records[].objectIDstringyesUnique record identifier.
referenceIndexNamestringnoThis is required when targeting an index that does not have a push connector setup (e.g. a tmp index), but you wish to attach another index's transformation to it (e.g. the source index name).
watchbooleannoWhen provided, the push operation will be synchronous and the API will wait for the ingestion to be finished before responding.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
dataarray of objectThis field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
eventIDstringUniversally unique identifier (UUID) of an event.
eventsarray of objectin case of error, observability events will be added to the response.
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
messagestringa message describing the outcome of the operation that has been ran (push, discover or validate) run.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "send a batch of documents to an index", "upload records through the pipeline now", "index some data without setting up a connector".

algolia_ingestion.list_runs

List the Algolia ingestion runs: the history of pipeline executions, each a past job that pulled and imported data, with status and timing. Calls GET /1/runs.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/runs.

Arguments:

ArgumentTypeRequiredNotes
endDatestringnoDate and time for the latest run to retrieve, in RFC 3339 format. By default, the current day is used.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of status, updatedAt, createdAtnoProperty by which to sort the list of task runs. Defaults to createdAt.
startDatestringnoDate and time for the earliest run to retrieve, in RFC 3339 format. By default, the current day minus seven days is used.
statusarray of stringnoRun status for filtering the list of task runs.
taskIDstringnoTask ID for filtering the list of task runs.
typearray of stringnoRun type for filtering the list of task runs.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
runsarray of object
runs[].appIDstring
runs[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
runs[].failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
runs[].finishedAtstringDate and time when the task finished, in RFC 3339 format.
runs[].outcomestring, one of success, failureTask run outcome.
runs[].progressobject
runs[].reasonstringMore information about the task run's outcome.
runs[].reasonCodestring, one of internal, cancelled, critical, no_events, too_many_errors, lacking_events, ok, blocking, idleA code for the task run's outcome. A readable description of the code is included in the reason response property.
runs[].runIDstringUniversally unique identifier (UUID) of a task run.
runs[].startedAtstringDate and time when the task started, in RFC 3339 format.
runs[].statusstring, one of created, started, finished, skippedTask run status.
runs[].taskIDstringUniversally unique identifier (UUID) of a task.
runs[].typestring, one of reindex, update, discover, validate, pushTask run type.
windowobjectTime window by which to filter the observability data.
window.endDatestringDate and time representing the newest data in the time window, in RFC 3339 format.
window.startDatestringDate and time representing the oldest data in the time window, in RFC 3339 format.

Also retrieved by: "show the history of pipeline executions", "list past ingestion jobs and their status", "what pipeline runs have happened".

algolia_ingestion.get_run

Get one Algolia ingestion run by its id: the details of a single pipeline execution, its status, and how much data it moved. Calls GET /1/runs/{runID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/runs/{{params.runID}}.

Arguments:

ArgumentTypeRequiredNotes
runIDstringyesUnique identifier of a task run.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
appIDstring
createdAtstringDate and time when the resource was created, in RFC 3339 format.
failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
finishedAtstringDate and time when the task finished, in RFC 3339 format.
outcomestring, one of success, failureTask run outcome.
progressobject
progress.expectedNbOfEventsinteger
progress.receivedNbOfEventsinteger
reasonstringMore information about the task run's outcome.
reasonCodestring, one of internal, cancelled, critical, no_events, too_many_errors, lacking_events, ok, blocking, idleA code for the task run's outcome. A readable description of the code is included in the reason response property.
runIDstringUniversally unique identifier (UUID) of a task run.
startedAtstringDate and time when the task started, in RFC 3339 format.
statusstring, one of created, started, finished, skippedTask run status.
taskIDstringUniversally unique identifier (UUID) of a task.
typestring, one of reindex, update, discover, validate, pushTask run type.

Also retrieved by: "look up one pipeline execution by id", "show the details of a single ingestion job", "how did one run go".

algolia_ingestion.list_events

List the events of one Algolia ingestion run: the log lines and step records emitted during a single pipeline execution, for debugging. Calls GET /1/runs/{runID}/events.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/runs/{{params.runID}}/events.

Arguments:

ArgumentTypeRequiredNotes
endDatestringnoDate and time in RFC 3339 format for the latest events to retrieve. By default, the current time is used.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
runIDstringyesUnique identifier of a task run.
sortstring, one of status, type, publishedAtnoProperty by which to sort the list of task run events.
startDatestringnoDate and time in RFC 3339 format for the earliest events to retrieve. By default, the current time minus three hours is used.
statusarray of stringnoEvent status for filtering the list of task runs.
typearray of stringnoEvent type for filtering the list of task runs.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
eventsarray of object
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
windowobjectTime window by which to filter the observability data.
window.endDatestringDate and time representing the newest data in the time window, in RFC 3339 format.
window.startDatestringDate and time representing the oldest data in the time window, in RFC 3339 format.

Also retrieved by: "show the log lines of a pipeline execution", "the step by step records of one run", "debug what happened during a job".

algolia_ingestion.get_event

Get one event of an Algolia ingestion run: a single log line or step record from a pipeline execution, with its message and timing, for debugging. Calls GET /1/runs/{runID}/events/{eventID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/runs/{{params.runID}}/events/{{params.eventID}}.

Arguments:

ArgumentTypeRequiredNotes
eventIDstringyesUnique identifier of an event.
runIDstringyesUnique identifier of a task run.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
batchSizeintegerThe extracted record batch size.
dataobject
eventIDstringUniversally unique identifier (UUID) of an event.
publishedAtstringDate and time when the resource was published, in RFC 3339 format.
runIDstringUniversally unique identifier (UUID) of a task run.
statusstring, one of created, started, retried, failed, succeeded, critical
typestring, one of fetch, record, log, transform

Also retrieved by: "open one log line from a job", "what does this single step record say", "drill into one entry of a run's log".

algolia_ingestion.list_sources

List the Algolia ingestion sources: the upstream systems, databases, and connectors the pipeline pulls and draws data from. Calls GET /1/sources.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/sources.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDarray of stringnoAuthentication IDs of the sources to retrieve. 'none' returns sources that doesn't have an authentication.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of name, type, updatedAt, createdAtnoProperty by which to sort the list of sources. Defaults to createdAt.
typearray of stringnoSource type. Some sources require authentication.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
sourcesarray of object
sources[].authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
sources[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
sources[].inputobjectSpecific configuration attributes of a commercetools source.
sources[].namestring
sources[].ownerstringOwner of the resource.
sources[].sourceIDstringUniversally uniqud identifier (UUID) of a source.
sources[].typestring, one of algoliaIndex, bigcommerce, bigquery, commercetools, csv, docker, ga4BigqueryExport, json, shopify, push
sources[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "which upstream systems do we pull from", "show the connectors we draw data from", "list the inputs feeding the pipeline".

algolia_ingestion.create_source

Create an Algolia ingestion source: connect a new upstream system, database, or connector to draw and pull data from into the pipeline. Calls POST /1/sources.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
inputobjectnoSpecific configuration attributes of a commercetools source.
input.customFieldsobjectnoCustom fields from commercetools to add to the records. For more information, see Using Custom Types and Custom Fields.
input.fallbackIsInStockValuebooleannoWhether a fallback value is stored in the Algolia record if there's no inventory information about the product. Defaults to true.
input.localesarraynoLocales for your commercetools stores.
input.productQueryPredicatestringnoPredicate to filter out specific products when indexing. For more information, see Query Predicate.
input.projectKeystringyes
input.storeKeysarrayno
input.urlstringyes
input.useImagesObjectsbooleannoWhen set to true, the connector indexes objects with all images attributes instead of only the URLs.
namestringyesDescriptive name of the source.
typestring, one of algoliaIndex, bigcommerce, bigquery, commercetools, csv, docker, ga4BigqueryExport, json, shopify, pushyes

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
namestringDescriptive name of the source.
sourceIDstringUniversally uniqud identifier (UUID) of a source.

Also retrieved by: "connect a new upstream system", "add a connector to draw data from", "hook up an input to the pipeline".

algolia_ingestion.search_sources

Search the Algolia ingestion sources: filter the upstream systems and connectors the pipeline pulls from by name or type instead of paging the whole list. Calls POST /1/sources/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources/search.

Arguments:

ArgumentTypeRequiredNotes
sourceIDsarray of stringyes

Also retrieved by: "find an upstream connector by name", "which inputs match this filter", "filter the systems we pull data from".

algolia_ingestion.validate_source

Check an Algolia ingestion source before saving it: confirm the connection details are usable and the upstream system can actually be reached. Calls POST /1/sources/validate.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources/validate.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
inputobjectnoSpecific configuration attributes of a commercetools source.
input.customFieldsobjectnoCustom fields from commercetools to add to the records. For more information, see Using Custom Types and Custom Fields.
input.fallbackIsInStockValuebooleannoWhether a fallback value is stored in the Algolia record if there's no inventory information about the product. Defaults to true.
input.localesarraynoLocales for your commercetools stores.
input.productQueryPredicatestringnoPredicate to filter out specific products when indexing. For more information, see Query Predicate.
input.projectKeystringyes
input.storeKeysarrayno
input.urlstringyes
input.useImagesObjectsbooleannoWhen set to true, the connector indexes objects with all images attributes instead of only the URLs.
namestringyesDescriptive name of the source.
typestring, one of algoliaIndex, bigcommerce, bigquery, commercetools, csv, docker, ga4BigqueryExport, json, shopify, pushyes

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
dataarray of objectThis field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
eventIDstringUniversally unique identifier (UUID) of an event.
eventsarray of objectin case of error, observability events will be added to the response.
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
messagestringa message describing the outcome of the operation that has been ran (push, discover or validate) run.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "test a connection before saving it", "can the pipeline reach this system", "dry run the settings for a new input".

algolia_ingestion.get_source

Get one Algolia ingestion source by its id: the upstream system or connector the pipeline draws data from, and how it is configured. Calls GET /1/sources/{sourceID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/sources/{{params.sourceID}}.

Arguments:

ArgumentTypeRequiredNotes
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDstringUniversally unique identifier (UUID) of an authentication resource.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
inputobjectSpecific configuration attributes of a commercetools source.
input.customFieldsobjectCustom fields from commercetools to add to the records. For more information, see Using Custom Types and Custom Fields.
input.fallbackIsInStockValuebooleanWhether a fallback value is stored in the Algolia record if there's no inventory information about the product. Defaults to true.
input.localesarrayLocales for your commercetools stores.
input.productQueryPredicatestringPredicate to filter out specific products when indexing. For more information, see Query Predicate.
input.projectKeystring
input.storeKeysarray
input.urlstring
input.useImagesObjectsbooleanWhen set to true, the connector indexes objects with all images attributes instead of only the URLs.
namestring
ownerstringOwner of the resource.
sourceIDstringUniversally uniqud identifier (UUID) of a source.
typestring, one of algoliaIndex, bigcommerce, bigquery, commercetools, csv, docker, ga4BigqueryExport, json, shopify, push
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "show one input connector by id", "how is this upstream system configured", "details of a single data feed".

algolia_ingestion.update_source

Update an Algolia ingestion source: change the upstream system's connection details, credentials, or settings so the pipeline pulls from it differently. Calls PATCH /1/sources/{sourceID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PATCH /1/sources/{{params.sourceID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
inputobjectnoSpecific configuration attributes of a commercetools source.
input.customFieldsobjectnoCustom fields from commercetools to add to the records. For more information, see Using Custom Types and Custom Fields.
input.fallbackIsInStockValuebooleannoWhether a fallback value is stored in the Algolia record if there's no inventory information about the product.
input.localesarraynoLocales for your commercetools stores.
input.productQueryPredicatestringnoPredicate to filter out specific products when indexing. For more information, see Query Predicate.
input.storeKeysarrayno
input.urlstringno
input.useImagesObjectsbooleannoWhen set to true, the connector indexes objects with all images attributes instead of only the URLs.
namestringnoDescriptive name of the source.
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
namestringDescriptive name of the source.
sourceIDstringUniversally uniqud identifier (UUID) of a source.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "change the settings of an input connector", "repoint the feed at a different database", "edit how we pull from an upstream system".

algolia_ingestion.delete_source

Delete an Algolia ingestion source: disconnect an upstream system so the pipeline no longer pulls data from it. Calls DELETE /1/sources/{sourceID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /1/sources/{{params.sourceID}}.

Arguments:

ArgumentTypeRequiredNotes
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "disconnect an upstream system", "stop pulling data from this feed", "remove an input we no longer use".

algolia_ingestion.trigger_docker_source_discover

Ask an Algolia ingestion source to list what it can offer: run discovery against a connector so its available streams, tables, and collections come back. Calls POST /1/sources/{sourceID}/discover.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources/{{params.sourceID}}/discover.

Arguments:

ArgumentTypeRequiredNotes
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
dataarray of objectThis field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
eventIDstringUniversally unique identifier (UUID) of an event.
eventsarray of objectin case of error, observability events will be added to the response.
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
messagestringa message describing the outcome of the operation that has been ran (push, discover or validate) run.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "what tables can this connector see", "list the streams available from a feed", "run discovery against an upstream system".

algolia_ingestion.run_source

Run an Algolia ingestion source: kick off every task and job attached to one upstream connector so its data is pulled in now. Calls POST /1/sources/{sourceID}/run.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources/{{params.sourceID}}/run.

Arguments:

ArgumentTypeRequiredNotes
entityIDsarray of stringnoList of entityIDs to update.
entityTypestring, one of product, collectionnoType of entity to update.
indexToExcludearray of stringnoList of index names to exclude in reindex/update.
indexToIncludearray of stringnoList of index names to include in reindex/update.
runMetadataobjectnoAdditional information that will be passed to the created runs.
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
taskWithRunIDobjectMap of taskID sent for reindex with the corresponding runID.

Also retrieved by: "kick off the jobs for one connector", "pull data from an upstream system now", "trigger everything attached to a source".

algolia_ingestion.validate_source_before_update

Check a change to an Algolia ingestion source before saving it: confirm the edited connection details are usable and the upstream system still answers. Calls POST /1/sources/{sourceID}/validate.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/sources/{{params.sourceID}}/validate.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDstringnoUniversally unique identifier (UUID) of an authentication resource.
inputobjectnoSpecific configuration attributes of a commercetools source.
input.customFieldsobjectnoCustom fields from commercetools to add to the records. For more information, see Using Custom Types and Custom Fields.
input.fallbackIsInStockValuebooleannoWhether a fallback value is stored in the Algolia record if there's no inventory information about the product.
input.localesarraynoLocales for your commercetools stores.
input.productQueryPredicatestringnoPredicate to filter out specific products when indexing. For more information, see Query Predicate.
input.storeKeysarrayno
input.urlstringno
input.useImagesObjectsbooleannoWhen set to true, the connector indexes objects with all images attributes instead of only the URLs.
namestringnoDescriptive name of the source.
sourceIDstringyesUnique identifier of a source.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
dataarray of objectThis field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
eventIDstringUniversally unique identifier (UUID) of an event.
eventsarray of objectin case of error, observability events will be added to the response.
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
messagestringa message describing the outcome of the operation that has been ran (push, discover or validate) run.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "test an edit to a connector before saving", "does the upstream still answer with these changes", "verify new settings on an existing feed".

algolia_ingestion.list_tasks_v1

List the Algolia ingestion tasks on the older v1 API: the scheduled jobs that move data from a source into a destination, as the first generation of the endpoint returns them. Calls GET /1/tasks.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/tasks.

Arguments:

ArgumentTypeRequiredNotes
actionarray of stringnoActions for filtering the list of tasks.
destinationIDarray of stringnoDestination IDs for filtering the list of tasks.
enabledbooleannoWhether to filter the list of tasks by the enabled status.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of enabled, triggerType, action, updatedAt, createdAtnoProperty by which to sort the list of tasks. Defaults to createdAt.
sourceIDarray of stringnoSource IDs for filtering the list of tasks.
triggerTypearray of stringnoType of task trigger for filtering the list of tasks.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
tasksarray of object
tasks[].actionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
tasks[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
tasks[].cursorstringDate and time when the last cursor was created, in RFC 3339 format.
tasks[].destinationIDstringUniversally unique identifier (UUID) of a destination resource.
tasks[].enabledbooleanWhether the task is enabled. Defaults to true.
tasks[].failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
tasks[].inputobjectConfiguration of the task, depending on its type.
tasks[].notificationsobjectNotifications settings for a task.
tasks[].policiesobjectSet of rules for a task.
tasks[].sourceIDstringUniversally uniqud identifier (UUID) of a source.
tasks[].taskIDstringUniversally unique identifier (UUID) of a task.
tasks[].triggerobjectTrigger that runs the task.
tasks[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "show the scheduled jobs on the old task api", "list v1 ingestion jobs", "what tasks exist under the first generation endpoint".

algolia_ingestion.create_task_v1

Create an Algolia ingestion task on the older v1 API: schedule a new job that moves data from one source into one destination. Calls POST /1/tasks.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/tasks.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of replace, save, partial, partialNoCreate, appendyesAction to perform on the Algolia index.
cursorstringnoDate and time when the last cursor was created, in RFC 3339 format.
destinationIDstringyesUniversally unique identifier (UUID) of a destination resource.
enabledbooleannoWhether the task is enabled.
failureThresholdintegernoMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectnoConfiguration of the task, depending on its type.
input.mappingobjectyesTransformations to apply to the source, serialized as a JSON string.
sourceIDstringyesUniversally uniqud identifier (UUID) of a source.
triggerobjectyesTrigger information for manually-triggered tasks.
trigger.typestring, one of onDemandyesTask is run manually, with the /run endpoint.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
taskIDstringUniversally unique identifier (UUID) of a task.

Also retrieved by: "schedule a job on the v1 task api", "set up an old-style ingestion task", "add a data-moving job under the legacy endpoint".

algolia_ingestion.search_tasks_v1

Search the Algolia ingestion tasks on the older v1 API: filter the scheduled jobs by source, destination, or trigger instead of paging the whole list. Calls POST /1/tasks/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/tasks/search.

Arguments:

ArgumentTypeRequiredNotes
taskIDsarray of stringyes

Also retrieved by: "filter v1 ingestion jobs", "find an old-style task by its source", "which legacy jobs match this filter".

algolia_ingestion.get_task_v1

Get one Algolia ingestion task on the older v1 API: a single scheduled job, its source, its destination, and its trigger. Calls GET /1/tasks/{taskID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
actionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
cursorstringDate and time when the last cursor was created, in RFC 3339 format.
destinationIDstringUniversally unique identifier (UUID) of a destination resource.
enabledbooleanWhether the task is enabled. Defaults to true.
failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectConfiguration of the task, depending on its type.
input.mappingobjectTransformations to apply to the source, serialized as a JSON string.
notificationsobjectNotifications settings for a task.
notifications.emailobject
policiesobjectSet of rules for a task.
policies.criticalThresholdintegerThe number of critical failures in a row before blocking the task and sending a notification.
sourceIDstringUniversally uniqud identifier (UUID) of a source.
taskIDstringUniversally unique identifier (UUID) of a task.
triggerobjectTrigger that runs the task.
trigger.lastRunstringThe last time the scheduled task ran in RFC 3339 format.
trigger.typestring, one of onDemandTask is run manually, with the /run endpoint.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "open one job on the v1 task api", "how is this legacy task configured", "show a single old-style ingestion job".

algolia_ingestion.update_task_v1

Update an Algolia ingestion task on the older v1 API: change a scheduled job's trigger, input, or settings. Calls PATCH /1/tasks/{taskID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PATCH /1/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
destinationIDstringnoUniversally unique identifier (UUID) of a destination resource.
enabledbooleannoWhether the task is enabled.
failureThresholdintegernoMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectnoConfiguration of the task, depending on its type.
input.mappingobjectyesTransformations to apply to the source, serialized as a JSON string.
taskIDstringyesUnique identifier of a task.
triggerobjectnoTrigger for a task update.
trigger.cronstringyesCron expression for the task's schedule.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "change the schedule of a v1 job", "edit an old-style ingestion task", "retune a legacy data-moving job".

algolia_ingestion.delete_task_v1

Delete an Algolia ingestion task on the older v1 API: remove a scheduled job so it never runs again. Calls DELETE /1/tasks/{taskID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /1/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "remove a job from the v1 task api", "get rid of an old-style ingestion task", "stop a legacy job running ever again".

algolia_ingestion.disable_task_v1

Pause an Algolia ingestion task on the older v1 API: stop a scheduled job firing while keeping its configuration. Calls PUT /1/tasks/{taskID}/disable.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /1/tasks/{{params.taskID}}/disable.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "pause a job on the v1 task api", "turn off an old-style scheduled task", "stop a legacy job firing for now".

algolia_ingestion.enable_task_v1

Resume an Algolia ingestion task on the older v1 API: let a paused scheduled job fire on its trigger again. Calls PUT /1/tasks/{taskID}/enable.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /1/tasks/{{params.taskID}}/enable.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "resume a paused job on the v1 task api", "switch an old-style task back on", "let a legacy job fire again".

algolia_ingestion.run_task_v1

Run an Algolia ingestion task now on the older v1 API: fire a scheduled job immediately instead of waiting for its trigger. Calls POST /1/tasks/{taskID}/run.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/tasks/{{params.taskID}}/run.

Arguments:

ArgumentTypeRequiredNotes
runMetadataobjectnoAdditional information that will be passed to the created run.
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "fire a v1 job right now", "run an old-style ingestion task immediately", "trigger a legacy job without waiting".

algolia_ingestion.list_transformations

List the Algolia ingestion transformations: the record-shaping and mapping steps defined to reshape data as it flows through the pipeline. Calls GET /1/transformations.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/transformations.

Arguments:

ArgumentTypeRequiredNotes
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of name, updatedAt, createdAtnoProperty by which to sort the list of transformations. Defaults to createdAt.
typestring, one of code, noCodenoWhether to filter the list of transformations by the type of transformation.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
transformationsarray of object
transformations[].authenticationIDsarrayThe authentications associated with the current transformation.
transformations[].codestringIt is deprecated. Use the input field with proper type instead to specify the transformation code.
transformations[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
transformations[].descriptionstringA descriptive name for your transformation of what it does.
transformations[].inputobjectThe input for the transformation, which can be either code or a no-code configuration.
transformations[].namestringThe uniquely identified name of your transformation.
transformations[].ownerstringOwner of the resource.
transformations[].transformationIDstringUniversally unique identifier (UUID) of a transformation.
transformations[].typestring, one of code, noCodeThe type of transformation, which can be either 'code' or 'noCode'.
transformations[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "show the record-shaping steps we defined", "list the mapping rules in the pipeline", "what reshaping steps exist".

algolia_ingestion.create_transformation

Create an Algolia ingestion transformation: define a new step that reshapes, maps, or enriches incoming records inside the pipeline. Calls POST /1/transformations.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/transformations.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDsarray of stringnoThe authentications associated with the current transformation.
codestringnoIt is deprecated. Use the input field with proper type instead to specify the transformation code.
descriptionstringnoA descriptive name for your transformation of what it does.
inputobjectnoThe input for the transformation, which can be either code or a no-code configuration.
input.codestringyesThe source code of the transformation.
namestringyesThe uniquely identified name of your transformation.
typestring, one of code, noCodenoThe type of transformation, which can be either 'code' or 'noCode'.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
transformationIDstringUniversally unique identifier (UUID) of a transformation.

Also retrieved by: "define a step that reshapes records", "add a mapping rule to the pipeline", "set up a new data-shaping step".

algolia_ingestion.search_transformations

Search the Algolia ingestion transformations: filter the record-shaping steps by name or code instead of paging the whole list. Calls POST /1/transformations/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/transformations/search.

Arguments:

ArgumentTypeRequiredNotes
transformationIDsarray of stringyes

Also retrieved by: "find a shaping step by name", "which mapping rules match this filter", "filter the record transforms we defined".

algolia_ingestion.try_transformation

Try an Algolia ingestion transformation on a sample: preview how a record-shaping step would change a record before saving the step. Calls POST /1/transformations/try.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/transformations/try.

Arguments:

ArgumentTypeRequiredNotes
authenticationsarray of objectno
authentications[].inputobjectyesCredentials for authenticating with a Google service account, such as BigQuery.
authentications[].namestringyesDescriptive name for the resource.
authentications[].platformstring, one of bigcommerce, commercetools, shopifynoName of an ecommerce platform with which to authenticate. This determines which authentication type you can select.
authentications[].typestring, one of googleServiceAccount, basic, apiKey, oauth, algolia, algoliaInsights, secretsyesType of authentication. This determines the type of credentials required in the input object.
codestringnoIt is deprecated. Use the input field with proper type instead to specify the transformation code.
inputobjectnoThe input for the transformation, which can be either code or a no-code configuration.
input.codestringyesThe source code of the transformation.
sampleRecordobjectyesThe record to apply the given code to.
typestring, one of code, noCodenoThe type of transformation, which can be either 'code' or 'noCode'.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
errorobjectThe error if the transformation failed.
error.codeintegerThe error status code.
error.messagestringA descriptive message explaining the failure.
payloadsarray of stringThe array of stringified records returned by the transformation service.

Also retrieved by: "preview how a shaping step changes a record", "test a mapping rule before saving it", "dry run a reshaping step on a sample".

algolia_ingestion.get_transformation

Get one Algolia ingestion transformation: a single record-shaping step, its code, and what it does to records passing through. Calls GET /1/transformations/{transformationID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /1/transformations/{{params.transformationID}}.

Arguments:

ArgumentTypeRequiredNotes
transformationIDstringyesUnique identifier of a transformation.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
authenticationIDsarray of stringThe authentications associated with the current transformation.
codestringIt is deprecated. Use the input field with proper type instead to specify the transformation code.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
descriptionstringA descriptive name for your transformation of what it does.
inputobjectThe input for the transformation, which can be either code or a no-code configuration.
input.codestringThe source code of the transformation.
namestringThe uniquely identified name of your transformation.
ownerstringOwner of the resource.
transformationIDstringUniversally unique identifier (UUID) of a transformation.
typestring, one of code, noCodeThe type of transformation, which can be either 'code' or 'noCode'.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "open one shaping step by id", "what does this mapping rule do", "show the code of a single transform".

algolia_ingestion.update_transformation

Replace an Algolia ingestion transformation: rewrite the code of a record-shaping step so records are mapped differently from now on. Calls PUT /1/transformations/{transformationID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /1/transformations/{{params.transformationID}}.

Arguments:

ArgumentTypeRequiredNotes
authenticationIDsarray of stringnoThe authentications associated with the current transformation.
codestringnoIt is deprecated. Use the input field with proper type instead to specify the transformation code.
descriptionstringnoA descriptive name for your transformation of what it does.
inputobjectnoThe input for the transformation, which can be either code or a no-code configuration.
input.codestringyesThe source code of the transformation.
namestringyesThe uniquely identified name of your transformation.
transformationIDstringyesUnique identifier of a transformation.
typestring, one of code, noCodenoThe type of transformation, which can be either 'code' or 'noCode'.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
transformationIDstringUniversally unique identifier (UUID) of a transformation.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "rewrite the code of a shaping step", "change how records are mapped", "update a transform's logic".

algolia_ingestion.delete_transformation

Delete an Algolia ingestion transformation: remove a record-shaping step so records flow through unchanged. Calls DELETE /1/transformations/{transformationID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /1/transformations/{{params.transformationID}}.

Arguments:

ArgumentTypeRequiredNotes
transformationIDstringyesUnique identifier of a transformation.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "remove a shaping step from the pipeline", "stop mapping records through this rule", "drop a transform we no longer need".

algolia_ingestion.try_transformation_before_update

Try a changed Algolia ingestion transformation on a sample record: preview what the edited shaping step would do before saving the change. Calls POST /1/transformations/{transformationID}/try.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /1/transformations/{{params.transformationID}}/try.

Arguments:

ArgumentTypeRequiredNotes
authenticationsarray of objectno
authentications[].inputobjectyesCredentials for authenticating with a Google service account, such as BigQuery.
authentications[].namestringyesDescriptive name for the resource.
authentications[].platformstring, one of bigcommerce, commercetools, shopifynoName of an ecommerce platform with which to authenticate. This determines which authentication type you can select.
authentications[].typestring, one of googleServiceAccount, basic, apiKey, oauth, algolia, algoliaInsights, secretsyesType of authentication. This determines the type of credentials required in the input object.
codestringnoIt is deprecated. Use the input field with proper type instead to specify the transformation code.
inputobjectnoThe input for the transformation, which can be either code or a no-code configuration.
input.codestringyesThe source code of the transformation.
sampleRecordobjectyesThe record to apply the given code to.
transformationIDstringyesUnique identifier of a transformation.
typestring, one of code, noCodenoThe type of transformation, which can be either 'code' or 'noCode'.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
errorobjectThe error if the transformation failed.
error.codeintegerThe error status code.
error.messagestringA descriptive message explaining the failure.
payloadsarray of stringThe array of stringified records returned by the transformation service.

Also retrieved by: "preview an edit to a shaping step", "what would the new code do to this record", "test a changed mapping rule on a sample".

algolia_ingestion.list_tasks

List the Algolia ingestion tasks: the scheduled jobs that move data from a source into a destination, with their triggers and current state. Calls GET /2/tasks.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /2/tasks.

Arguments:

ArgumentTypeRequiredNotes
actionarray of stringnoActions for filtering the list of tasks.
destinationIDarray of stringnoDestination IDs for filtering the list of tasks.
enabledbooleannoWhether to filter the list of tasks by the enabled status.
itemsPerPageintegernoNumber of items per page. Defaults to 10.
orderstring, one of asc, descnoSort order of the response, ascending or descending. Defaults to desc.
pageintegernoPage number of the paginated API response.
sortstring, one of enabled, triggerType, action, updatedAt, createdAtnoProperty by which to sort the list of tasks. Defaults to createdAt.
sourceIDarray of stringnoSource IDs for filtering the list of tasks.
sourceTypearray of stringnoFilters the tasks with the specified source type.
triggerTypearray of stringnoType of task trigger for filtering the list of tasks.
withEmailNotificationsbooleannoIf specified, the response only includes tasks with notifications.email.enabled set to this value.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
paginationobjectPaginated API response.
pagination.itemsPerPageintegerNumber of items per page. Defaults to 10.
pagination.nbItemsintegerNumber of items in the API response.
pagination.nbPagesintegerNumber of pages in the API response.
pagination.pageintegerPage of the API response to retrieve.
tasksarray of object
tasks[].actionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
tasks[].createdAtstringDate and time when the resource was created, in RFC 3339 format.
tasks[].cronstringCron expression for the task's schedule.
tasks[].cursorstringDate and time when the last cursor was created, in RFC 3339 format.
tasks[].destinationIDstringUniversally unique identifier (UUID) of a destination resource.
tasks[].enabledbooleanWhether the task is enabled. Defaults to true.
tasks[].failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
tasks[].inputobjectConfiguration of the task, depending on its type.
tasks[].lastRunstringThe last time the scheduled task ran in RFC 3339 format.
tasks[].nextRunstringThe next scheduled run of the task in RFC 3339 format.
tasks[].notificationsobjectNotifications settings for a task.
tasks[].ownerstringOwner of the resource.
tasks[].policiesobjectSet of rules for a task.
tasks[].sourceIDstringUniversally uniqud identifier (UUID) of a source.
tasks[].subscriptionActionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
tasks[].taskIDstringUniversally unique identifier (UUID) of a task.
tasks[].updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "show the scheduled ingestion jobs", "what jobs move data into our indices", "list the pipeline's jobs and triggers".

algolia_ingestion.create_task

Create an Algolia ingestion task: schedule a new job that moves data from one source into one destination on a trigger. Calls POST /2/tasks.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /2/tasks.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of replace, save, partial, partialNoCreate, appendyesAction to perform on the Algolia index.
cronstringnoCron expression for the task's schedule.
cursorstringnoDate and time when the last cursor was created, in RFC 3339 format.
destinationIDstringyesUniversally unique identifier (UUID) of a destination resource.
enabledbooleannoWhether the task is enabled.
failureThresholdintegernoMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectnoConfiguration of the task, depending on its type.
input.mappingobjectyesTransformations to apply to the source, serialized as a JSON string.
notificationsobjectnoNotifications settings for a task.
notifications.emailobjectyes
policiesobjectnoSet of rules for a task.
policies.criticalThresholdintegernoThe number of critical failures in a row before blocking the task and sending a notification.
sourceIDstringyesUniversally uniqud identifier (UUID) of a source.
subscriptionActionstring, one of replace, save, partial, partialNoCreate, appendnoAction to perform on the Algolia index.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
taskIDstringUniversally unique identifier (UUID) of a task.

Also retrieved by: "schedule a job to import data", "set up a new pipeline job on a trigger", "add a job that loads a source into an index".

algolia_ingestion.search_tasks

Search the Algolia ingestion tasks: filter the scheduled jobs by source, destination, or trigger instead of paging the whole list. Calls POST /2/tasks/search.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /2/tasks/search.

Arguments:

ArgumentTypeRequiredNotes
taskIDsarray of stringyes

Also retrieved by: "find an ingestion job by its source", "which scheduled jobs write to this index", "filter the pipeline's jobs".

algolia_ingestion.get_task

Get one Algolia ingestion task: a single scheduled job, where it reads from, where it writes to, and when it fires. Calls GET /2/tasks/{taskID}.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /2/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
actionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
createdAtstringDate and time when the resource was created, in RFC 3339 format.
cronstringCron expression for the task's schedule.
cursorstringDate and time when the last cursor was created, in RFC 3339 format.
destinationIDstringUniversally unique identifier (UUID) of a destination resource.
enabledbooleanWhether the task is enabled. Defaults to true.
failureThresholdintegerMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectConfiguration of the task, depending on its type.
input.mappingobjectTransformations to apply to the source, serialized as a JSON string.
lastRunstringThe last time the scheduled task ran in RFC 3339 format.
nextRunstringThe next scheduled run of the task in RFC 3339 format.
notificationsobjectNotifications settings for a task.
notifications.emailobject
ownerstringOwner of the resource.
policiesobjectSet of rules for a task.
policies.criticalThresholdintegerThe number of critical failures in a row before blocking the task and sending a notification.
sourceIDstringUniversally uniqud identifier (UUID) of a source.
subscriptionActionstring, one of replace, save, partial, partialNoCreate, appendAction to perform on the Algolia index.
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "open one ingestion job by id", "where does this job read and write", "show a single scheduled import".

algolia_ingestion.replace_task

Replace an Algolia ingestion task outright: send the whole job definition, overwriting every field rather than the few being changed. Calls PUT /2/tasks/{taskID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /2/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of replace, save, partial, partialNoCreate, appendyesAction to perform on the Algolia index.
cronstringnoCron expression for the task's schedule.
cursorstringnoDate and time when the last cursor was created, in RFC 3339 format.
destinationIDstringyesUniversally unique identifier (UUID) of a destination resource.
enabledbooleannoWhether the task is enabled.
failureThresholdintegernoMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectnoConfiguration of the task, depending on its type.
input.mappingobjectyesTransformations to apply to the source, serialized as a JSON string.
notificationsobjectnoNotifications settings for a task.
notifications.emailobjectyes
policiesobjectnoSet of rules for a task.
policies.criticalThresholdintegernoThe number of critical failures in a row before blocking the task and sending a notification.
subscriptionActionstring, one of replace, save, partial, partialNoCreate, appendnoAction to perform on the Algolia index.
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "overwrite a whole job definition", "send the full config for an import job", "replace every field of a scheduled job".

algolia_ingestion.update_task

Change part of an Algolia ingestion task: send only the fields being edited, such as its trigger, its input, or its notifications. Calls PATCH /2/tasks/{taskID}.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PATCH /2/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
cronstringnoCron expression for the task's schedule.
destinationIDstringnoUniversally unique identifier (UUID) of a destination resource.
enabledbooleannoWhether the task is enabled.
failureThresholdintegernoMaximum accepted percentage of failures for a task run to finish successfully.
inputobjectnoConfiguration of the task, depending on its type.
input.mappingobjectyesTransformations to apply to the source, serialized as a JSON string.
notificationsobjectnoNotifications settings for a task.
notifications.emailobjectyes
policiesobjectnoSet of rules for a task.
policies.criticalThresholdintegernoThe number of critical failures in a row before blocking the task and sending a notification.
subscriptionActionstring, one of replace, save, partial, partialNoCreate, appendnoAction to perform on the Algolia index.
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "change just the trigger of an import job", "edit one field of a scheduled job", "tweak an ingestion job's settings".

algolia_ingestion.delete_task

Delete an Algolia ingestion task: remove a scheduled job so no more data is moved on its trigger. Calls DELETE /2/tasks/{taskID}.

Class destructive (held by the mutation gate until the call's own arguments carry "confirm": true). No scopes beyond the connection's defaults. Calls DELETE /2/tasks/{{params.taskID}}.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
deletedAtstringDate and time when the resource was deleted, in RFC 3339 format.

Also retrieved by: "remove a scheduled import job", "stop a job moving data for good", "get rid of a pipeline job".

algolia_ingestion.disable_task

Pause an Algolia ingestion task: stop a scheduled job firing while keeping its definition intact. Calls PUT /2/tasks/{taskID}/disable.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /2/tasks/{{params.taskID}}/disable.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "pause an import job for now", "turn off a scheduled job without deleting it", "stop a pipeline job from firing".

algolia_ingestion.enable_task

Resume an Algolia ingestion task: let a paused job fire on its trigger again. Calls PUT /2/tasks/{taskID}/enable.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls PUT /2/tasks/{{params.taskID}}/enable.

Arguments:

ArgumentTypeRequiredNotes
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
taskIDstringUniversally unique identifier (UUID) of a task.
updatedAtstringDate and time when the resource was last updated, in RFC 3339 format.

Also retrieved by: "switch a paused import job back on", "let a scheduled job run again", "resume a stopped pipeline job".

algolia_ingestion.push_task

Push records into an Algolia ingestion task: hand a batch of documents to one job so they flow through its transformations into its destination index. Calls POST /2/tasks/{taskID}/push.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /2/tasks/{{params.taskID}}/push.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject, delete, clearyesWhich indexing operation to perform: - addObject: adds records to an index. Equivalent to the "Add a new record (with auto-generated object ID)" operation. - updateObject: adds or replaces...
recordsarray of objectyes
records[].objectIDstringyesUnique record identifier.
taskIDstringyesUnique identifier of a task.
watchbooleannoWhen provided, the push operation will be synchronous and the API will wait for the ingestion to be finished before responding.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
dataarray of objectThis field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
eventIDstringUniversally unique identifier (UUID) of an event.
eventsarray of objectin case of error, observability events will be added to the response.
events[].batchSizeintegerThe extracted record batch size.
events[].dataobject
events[].eventIDstringUniversally unique identifier (UUID) of an event.
events[].publishedAtstringDate and time when the resource was published, in RFC 3339 format.
events[].runIDstringUniversally unique identifier (UUID) of a task run.
events[].statusstring, one of created, started, retried, failed, succeeded, critical
events[].typestring, one of fetch, record, log, transform
messagestringa message describing the outcome of the operation that has been ran (push, discover or validate) run.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "hand a batch of documents to one job", "feed records into an existing import job", "send data through a job's transformations".

algolia_ingestion.run_task

Run an Algolia ingestion task now: fire a scheduled job immediately instead of waiting for its trigger. Calls POST /2/tasks/{taskID}/run.

Class write (writes, no confirmation needed). No scopes beyond the connection's defaults. Calls POST /2/tasks/{{params.taskID}}/run.

Arguments:

ArgumentTypeRequiredNotes
runMetadataobjectnoAdditional information that will be passed to the created run.
taskIDstringyesUnique identifier of a task.

Result fields (the payload is trimmed to these before it reaches the model):

FieldTypeNotes
createdAtstringDate and time when the resource was created, in RFC 3339 format.
runIDstringUniversally unique identifier (UUID) of a task run.

Also retrieved by: "run an import job right now", "fire a scheduled job immediately", "trigger a data load without waiting".

algolia_ingestion.chunked_push

Replace everything in an Algolia index through the ingestion pipeline: split a large batch of records into chunks of a thousand and push them all, swapping out the index's current contents. Calls GET /chunkedPush.

Class read (reads only). No scopes beyond the connection's defaults. Calls GET /chunkedPush.

Arguments:

ArgumentTypeRequiredNotes
actionstring, one of addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject, delete, clearnoThe batch action to perform on the given array of objects, defaults to addObject.
batchSizeintegernoThe size of the chunk of objects. The number of batch calls will be equal to length(objects) / batchSize. Defaults to 1,000.
indexNamestringyesThe indexName to replace objects in.
objectsarray of objectyesList of objects to replace the current objects with.
waitForTasksbooleannoWhether to wait until every batch task has been processed. This may take longer but is more reliable.

Also retrieved by: "reindex everything from a big batch", "swap out an index's whole contents", "bulk load a large record set in chunks".