Faraday lets you embed AI in workflows throughout your stack—to make your favorite tools perform even better
Faraday lets you embed AI in workflows throughout your stack—to make your favorite tools perform even better On Nagent, Faraday is exposed as a fully-configurable artificial intelligence integration that any agent can call — 117 actions, and API key authentication. No code is required to wire Faraday into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Faraday to automate the kinds of tasks artificial intelligence teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Faraday into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Faraday, with input parameters and output schema. Drop these into any step of an agent built in Helix.
FARADAY_ARCHIVE_COHORTTool to archive a cohort in Faraday. Use when you need to stop updates to a cohort while keeping it visible.
Input parameters
The UUID of the cohort to archive. Archiving stops updates but keeps the cohort visible. Example: 'ac030f6a-a728-4fcd-b34a-d5b7ba09d60c'
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the cohort and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_CONNECTIONTool to archive a connection in Faraday. Use when you need to stop updates to a connection while keeping it visible.
Input parameters
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
The UUID of the connection to archive. Archiving stops updates but keeps the connection visible. Example: 'eca0b539-5002-49f0-ac5e-ff4acd1d85b1'
When true, archive the connection and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_DATASETTool to archive a dataset in Faraday. Use when you need to archive a dataset and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
Input parameters
Only allow the following resources to be archived. If a downstream resource would be archived and is not in this list, throw an error. List of UUIDs.
The UUID of the dataset to archive.
When archiving a resource, if this is set to true, archive the resource and all its downstream resources. If false, and there are downstream resources that would be archived, throw an error.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_OUTCOMETool to archive an outcome in Faraday. Use when you need to stop updates to an outcome while keeping it visible.
Input parameters
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
The UUID of the outcome to archive. Archiving stops updates but keeps the outcome visible. Example: 'd0e90b8d-f69d-420d-b191-8438421cdc8e'
When true, archive the outcome and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_PERSONA_SETTool to archive a persona set in Faraday. Use when you need to stop updates to a persona set while keeping it visible.
Input parameters
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the persona set and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
The UUID of the persona set to archive. Archiving stops updates but keeps the persona set visible. Example: '8505e525-128c-4ede-a279-85f372aa6aaf'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_PLACETool to archive a place in Faraday. Use when you need to stop updates to a geospatial area or address set while keeping it visible.
Input parameters
The UUID of the place to archive. Archiving stops updates but keeps the place visible. Example: 'a1eafa5c-020a-427f-ae18-2d0b3c0fced7'
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the place and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_SCOPETool to archive a scope in Faraday. Use when you need to stop updates to a scope while keeping it visible.
Input parameters
The UUID of the scope to archive. Archiving stops updates but keeps the scope visible. Example: 'fce4d114-9516-4e8c-a92e-e1ed13d5369d'
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the scope and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_STREAMTool to archive a stream in Faraday. Use when you need to archive a stream and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
Input parameters
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the stream and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
The stream's UUID or name to archive. Example: 'b8907e67-dac8-4fc2-a332-7676f0077dd8'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_TARGETTool to archive a target in Faraday. Use when you need to archive a target and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
Input parameters
The UUID of the target to archive. Example: 'eb3450c4-f1d3-4edd-8d70-d1b4f7c16348'
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the target and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_ARCHIVE_TRAITTool to archive a trait in Faraday. Use when you need to stop updates to a trait while keeping it visible.
Input parameters
The UUID of the trait to archive. Archiving stops updates but keeps the trait visible. Example: '1b3411ea-0082-4873-bd3d-1f5c6586012e'
Only allow the following resource UUIDs to be archived. If a downstream resource would be archived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, archive the trait and all its downstream resources. When false, throw an error if there are downstream resources that would be archived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_ACCOUNTSTool to create a new Faraday account with specified name and branding. Use when you need to provision a new account in Faraday.
Input parameters
The name of the account. Must be non-empty and max 64 characters.
Whitelabel branding configuration for the account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_COHORTSTool to create a new cohort in Faraday. Cohorts are groups of people that share certain traits or behaviors. Use when you need to define a new cohort from your datasets or from Faraday's US Consumer Graph. At least one of stream_name, traits, or place_conditions must be provided.
Input parameters
Human-readable label for this cohort. Must be non-empty and max 64 characters.
List of traits to filter cohort membership. At least one of stream_name, traits, or place_conditions must be provided.
Whether to show the Cohort in Explore, the map view on https://app.faraday.ai. This will slow down Cohort builds.
Recency condition for event-based filtering.
Maximum count for this cohort's config
Maximum value for this cohort's config
Minimum count for this cohort's config
Minimum value for this cohort's config
The name field of the stream from which to build this cohort. At least one of stream_name, traits, or place_conditions must be provided.
List of places to use to spatially filter Cohort membership. At least one of stream_name, traits, or place_conditions must be provided.
List of stream properties to filter cohort membership on. The stream properties must be for the same stream set as the cohort stream_name. Nulls are excluded unless explicitly requested with _null: true.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_DATASETTool to create a new dataset in Faraday. Use when you need to define a new data source for analysis and predictions.
Input parameters
Identifying name for the dataset
Dataset connection options specifying how to connect to and read the data. Must include type field.
If true, dataset will only detect columns and produce preview without ingesting data.
Connection identifier in UUID format. Required if using a connection-based dataset type.
Mapping of identity set names to objects describing personally identifiable information. Each key is a logical grouping name (e.g., 'customers', 'leads') and the value describes how to extract PII from dataset rows.
Primary key columns that uniquely identify rows to prevent duplication.
Identity matching providers to use, in order of priority.
Name of a date column for efficient incremental data loading.
Column names that reference IDs from external systems.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_OUTCOMETool to create a new outcome. Outcomes are predictions about customer behavior such as likelihood to convert, churn, or purchase specific products. Use when you need to create a new predictive model.
Input parameters
Human-readable label for this outcome. Each outcome must have a unique name. Must be non-empty.
An outcome in preview mode will not build until preview is turned off.
Configuration for features used during modeling.
Bias mitigation configuration for age and gender dimensions.
Prediction mode for outcome modeling.
Field or category names that should not be considered for this outcome, primarily for Responsible AI purposes.
A cohort of people who could attain or attrite the desired outcome. If not specified, uses the US population.
A cohort of counterexamples - people who have clearly failed to attain the outcome.
A cohort of people who have attained the desired outcome (e.g., existing customers if predicting prospect to customer transition).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_PERSONA_SETTool to create a new persona set. Persona sets segment cohorts into distinct customer personas based on shared characteristics and behaviors. Use when you need to generate customer personas for a cohort.
Input parameters
Human-readable label for this persona set. Must be non-empty and max 64 characters.
Display persona set in Explore map view at https://app.faraday.ai. This will slow down persona set builds.
A persona set in preview mode will not build until preview is turned off.
The cohort for which to build personas.
Customer attributes for modeling (e.g., fig/age, fig/gender). These fields define the characteristics used to segment the cohort into personas.
Specific persona count. If omitted, the number of personas is automatically determined.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_PLACETool to create a new place in Faraday. Places are geospatial areas or sets of addresses that can be used as spatial filters when defining other resources. Use when you need to define a new geographic area for analysis or targeting.
Input parameters
Human-readable label for this place. Names must be unique. Uniqueness is case-insensitive. Must be non-empty and max 64 characters.
A GeoJSON Geometry, as defined in the GeoJSON specification. The longitude and latitude units are in decimal degrees, using the WGS84 coordinate reference system (SRID 4326). Either addresses or geojson must be provided.
List of addresses to be geocoded. Either addresses or geojson must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_SCOPESTool to create a new scope in Faraday. Scopes define the population and payload for predictions, specifying which cohorts to target and what outcomes to include. Use when you need to define output data instructions for a new scope.
Input parameters
Human-readable label for this scope. Each scope must have a unique name.
Specifies data to include for each person in the scope.
When true, provides limited output records without billing charges. A preview scope provides only a limited number of output records, but it is not billed.
Defines which people to include in the scope.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_STREAMSTool to create a new stream or find an existing stream by name. Use when you need to initialize a stream for event data collection.
Input parameters
The name of the event stream to find or create. Maximum length is 64 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_TARGET_PREVIEWTool to start a preview delivery for a target. Use when you need to initiate a preview of target data before full deployment.
Input parameters
The UUID of a target
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_TARGETSTool to create a target in Faraday. Use when you need to set up a deployment that exports predictions and cohort data to external destinations like CRMs, ad platforms, or data warehouses.
Input parameters
A user-friendly name for the target (max 64 characters)
Row restriction configuration by count or percentile.
Row-level filtering criteria for the target.
The export target configuration options varying by connection type
The UUID of a scope for configuration
For replication targets; omit for hosted targets
When true, use literal names instead of machine-readable IDs in the output
Specifies the output formatting mode (hashed, referenced, identified, or aggregated)
Configuration for geographic and trait analysis.
Column mapping transformations for custom output structure
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_TRAITTool to create a new trait in Faraday. Use when you need to define a new fact about a person or geographic entity that can be used in modeling, analysis, and reporting.
Input parameters
How to refer to this Trait in other API calls to Faraday. Must start with a lowercase letter or underscore, followed by lowercase letters, numbers, or underscores.
For numeric types, in what units is the data stored.
A more human-consumable version of the name of this field.
Information about this field.
A mapping of the input values used in modeling, to how they should be displayed in reports.
The nature of data represented by the trait.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_CREATE_WEBHOOK_ENDPOINTSTool to create a new webhook endpoint. Use when you need to register a webhook URL to receive notifications when resources are ready or encounter errors.
Input parameters
The destination URL for webhook notifications. Must be a valid HTTPS URL.
Event types that trigger the webhook. Must contain at least one event type. Available events: 'resource.errored' (when a resource encounters an error) and 'resource.ready_with_update' (when a resource is ready with updates).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_ACCOUNTTool to delete an account by its UUID. Use when you need to permanently remove an account from Faraday. The deletion is scheduled asynchronously and returns a 202 status on success.
Input parameters
The UUID of the account to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_ALL_ORPHANED_TRAITSTool to delete all orphaned traits from Faraday. Use when you need to clean up traits that are not associated with any source dataset.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_COHORTTool to permanently delete a cohort from Faraday. Use when you need to remove a cohort that is no longer needed.
Input parameters
The UUID of the cohort to delete. This permanently deletes the cohort. Example: '856bc7b0-f4d4-433b-9e46-199970d7b78c'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_CONNECTIONTool to delete a Faraday connection by its UUID. Use when you need to permanently remove a connection.
Input parameters
The UUID of the connection to delete. This permanently removes the connection from Faraday. Ensure no active processes depend on this connection before deletion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_DATASETTool to delete a dataset from Faraday. Use when you need to remove a dataset permanently. The operation returns success when the dataset is successfully deleted.
Input parameters
The UUID of the dataset to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_OUTCOMETool to delete an outcome by its UUID. Use when you need to remove an outcome from Faraday.
Input parameters
The UUID of the outcome to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_PERSONA_SETTool to delete a persona set. Use when you need to permanently remove a persona set from Faraday. Returns success status and HTTP code 204 on successful deletion.
Input parameters
The UUID of the persona set to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_PLACETool to delete a place by its UUID. Use when you need to remove a place from the system.
Input parameters
The UUID of the place to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_SCOPETool to delete a scope by its UUID. Use when you need to permanently remove a scope from the system. Returns 204 status code on successful deletion.
Input parameters
The UUID of the scope to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_STREAMTool to delete a stream by its UUID or name. Use when you need to remove a stream that is no longer needed.
Input parameters
The stream's UUID or name to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_TARGETTool to delete a target by its UUID. Use when you need to remove a target from Faraday.
Input parameters
The UUID of the target to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_UPLOADPermanently deletes a file from a Faraday dataset directory. Use this when you need to remove an uploaded file from a specific directory. This is a destructive operation that cannot be undone - the file will be permanently removed from the specified directory.
Input parameters
The name of an individual data file in a dataset to delete. Must include the file extension (e.g., '.csv', '.json'). Example: 'data_01.csv', 'orders_2024.csv'
A directory of files which can be imported as a single dataset. This is the folder name where the file is stored. Example: 'abc_orders', 'customer_orders'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_DELETE_WEBHOOK_ENDPOINTTool to delete a webhook endpoint by its UUID. Use when you need to remove a webhook endpoint from Faraday. The operation returns 204 No Content on success.
Input parameters
The UUID of the webhook endpoint to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_COHORTTool to trigger a rerun for a cohort. Use when you need to force rebuild a cohort's data.
Input parameters
The UUID of the cohort to force update. This triggers a rerun for the cohort. Example: 'ac030f6a-a728-4fcd-b34a-d5b7ba09d60c'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_CONNECTIONTool to trigger a rerun for a Faraday connection. Use when you need to force refresh connection data.
Input parameters
The UUID of the connection to trigger a rerun for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_DATASETTool to trigger a rerun for a dataset. Use when you need to force a dataset to update immediately rather than waiting for its normal schedule.
Input parameters
The UUID of the dataset to force update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_OUTCOMETool to trigger a rerun for an outcome resource. Use when you need to force rebuild an outcome, causing it to reprocess and update its predictions.
Input parameters
The UUID of the outcome to force update (trigger a rerun).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_PERSONA_SETTool to trigger a rerun for a persona set resource. Use when you need to force rebuild a persona set, causing it to reprocess and update its personas.
Input parameters
The UUID of the persona set to force update (trigger a rerun).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_PLACETool to trigger a rerun for a place. Use when you need to force rebuild a place's data.
Input parameters
The UUID of the place to force update. This triggers a rerun for the place. Example: 'a1eafa5c-020a-427f-ae18-2d0b3c0fced7'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_SCOPETool to trigger a rerun for a scope resource. Use when you need to force rebuild a scope, causing it to reprocess and update its data.
Input parameters
The UUID of the scope to force update (trigger a rerun).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_STREAMTool to trigger a rerun for a stream. Use when you need to force rebuild a stream's data.
Input parameters
The UUID or name of the stream to force update. This triggers a rerun for the stream. Example: 'b8907e67-dac8-4fc2-a332-7676f0077dd8' or 'orders'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_TARGETTool to trigger a rerun for a target. Use when you need to force rebuild a target's data.
Input parameters
The UUID of the target to force update. This triggers a rerun for the target. Example: 'eb3450c4-f1d3-4edd-8d70-d1b4f7c16348'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_FORCE_UPDATE_TRAITTool to trigger a rerun for a trait. Use when you need to force rebuild a trait's data.
Input parameters
The UUID of the trait to force update. This triggers a rerun for the trait. Example: '616aee5f-e544-43ff-a27e-5207248d4056'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_ACCOUNTTool to retrieve detailed information about a Faraday account by its UUID. Use when you need to fetch account details, status, branding, or billing information.
Input parameters
The UUID of the account to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_ACCOUNTSTool to list all Faraday accounts accessible by the current user. Use when you need to retrieve account information, check account status, or get account IDs for other operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_ACCOUNTS_BILLINGTool to get billing information about your account. Use when you need to retrieve invoices, payments, or usage information for a specific account.
Input parameters
The UUID of an account
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_COHORTTool to retrieve a specific cohort by ID. Use when you need to fetch details about a specific cohort.
Input parameters
The UUID of the cohort to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_COHORT_ANALYSIS_MEMBERSHIPTool to get cohort membership counts over time for a specific cohort. Use when you need to analyze how cohort membership has changed over days, weeks, and months.
Input parameters
The UUID of the cohort to analyze
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_COHORTSTool to list all cohorts in your Faraday account. Use when you need to retrieve the list of customer groups or segments.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_CONNECTION_DATASETSTool to retrieve all datasets that use a specific connection. Use when you need to list datasets associated with a connection ID.
Input parameters
The UUID of the connection to retrieve datasets for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_CONNECTIONS_TARGETSTool to retrieve all targets that use a specific connection. Use when you need to get a list of all targets associated with a connection ID.
Input parameters
The UUID of a connection
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_CURRENT_ACCOUNTTool to retrieve the current account information. Use when you need to get details about the authenticated account, including account ID, name, status, and billing information.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_CURRENT_ACCOUNT_BILLINGTool to retrieve billing information about the current account. Use when you need to check invoices, payments, or usage limits for the authenticated Faraday account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_DATASETTool to retrieve a dataset by its UUID. Use when you need to get details about a specific dataset including its configuration, columns, status, and metadata.
Input parameters
The UUID of the dataset to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_DATASETS_LOGS_INGRESSTool to retrieve dataset ingress metrics over time. Use when you need to monitor or analyze data ingestion history, track row counts, or review ingress operation status for a specific dataset.
Input parameters
Number of records to return (pagination)
Number of records to skip for pagination
UUID of the dataset to retrieve ingress logs for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_FEATURE_STORESTool to list all feature stores. Use when you need to retrieve feature stores from your Faraday account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_GRAPHTool to retrieve the complete dependency graph for all resources on an account. Shows relationships between datasets, cohorts, outcomes, targets, connections, and other resources.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_MARKET_OPPORTUNITY_ANALYSESTool to retrieve all market opportunity analyses from Faraday. Use when you need to view penetration and opportunity metrics in your market.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_OUTCOMETool to retrieve an outcome by its ID. Use when you need to get details about a specific outcome including its configuration, cohorts, status, and performance metrics.
Input parameters
The UUID of the outcome to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_OUTCOMESTool to list all outcomes for the account. Use when you need to retrieve configured business objectives and their modeling status. Returns complete list without pagination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PERSONA_SETTool to retrieve a persona set by its UUID. Use when you need to access details about a specific customer persona set including its status, configuration, and constituent personas.
Input parameters
The UUID of a persona set to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PERSONA_SET_ANALYSIS_FLOWTool to retrieve the flow of persona sets over time, showing how individuals move between different personas. Use when you need to analyze trends in persona membership or understand how your audience segments are evolving over time.
Input parameters
The UUID of a persona set
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PERSONA_SETSTool to list all persona sets. Use when you need to retrieve customer persona sets for analysis or selection.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PERSONA_SETS_ANALYSIS_DIMENSIONSTool to get various trait breakdown information about a persona set. Use when you need to analyze the characteristics and distributions of personas within a set.
Input parameters
The UUID of the persona set to retrieve analysis dimensions for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PLACETool to retrieve a specific place by its UUID. Use when you need to get details about a geospatial area or address set that can be used as a spatial filter.
Input parameters
The UUID of the place to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_PLACESTool to list all places in Faraday. Use when you need to retrieve geospatial areas or address sets that can be used as spatial filters. Returns all place resources with their status and configuration.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_RECOMMENDERSTool to list all recommenders. Use when you need to retrieve recommender resources that predict future associations based on event streams.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPETool to retrieve detailed information about a Faraday scope by its UUID. Use when you need to fetch scope configuration, population settings, payload details, or status information.
Input parameters
The UUID of the scope to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_ANALYSISTool to get analysis for a scope including outcomes and recommenders with probability distributions. Use when you need to analyze scope performance and understand prediction distributions.
Input parameters
The UUID of the scope to get analysis for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_DATASETSTool to retrieve all datasets associated with a Faraday scope. Use when you need to list or view all datasets that are connected to a specific scope.
Input parameters
The UUID of the scope to retrieve datasets for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_EFFICACYTool to retrieve efficacy metrics for a scope. Returns model performance metrics and accuracy measurements showing how well predictions performed over time.
Input parameters
The UUID of the scope to retrieve efficacy data for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_PAYLOAD_COHORTSTool to get payload cohorts for a specific scope. Use when you need to retrieve the list of cohorts included in a scope's payload configuration.
Input parameters
The UUID of the scope to retrieve payload cohorts for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_PAYLOAD_OUTCOMESTool to retrieve payload outcomes for a specific scope. Use when you need to fetch the outcome predictions included in a scope's data payload.
Input parameters
The UUID of the scope to retrieve payload outcomes for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_PAYLOAD_PERSONA_SETSTool to get payload persona sets for a specific scope. Use when you need to retrieve the list of persona sets included in a scope's payload configuration.
Input parameters
The UUID of the scope to retrieve payload persona sets for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_PAYLOAD_RECOMMENDERSTool to retrieve payload recommenders for a specific scope. Use when you need to fetch recommender resources associated with a scope's payload configuration.
Input parameters
The UUID of a scope
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_POPULATION_EXCLUSION_COHORTSTool to get population exclusion cohorts for a scope. Use when you need to retrieve the cohorts that are excluded from a specific scope's population.
Input parameters
The UUID of a scope
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPES_POPULATION_COHORTSTool to get population cohorts for a specific scope. Use when you need to retrieve the list of cohorts associated with a scope's population.
Input parameters
The UUID of a scope
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_SCOPE_TARGETSTool to get all targets for a specific scope. Use when you need to retrieve export configurations and target details for a scope.
Input parameters
The UUID of the scope to retrieve targets for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_STREAMTool to retrieve a stream by its UUID or name. Use when you need to fetch stream details including properties, event counts, and metadata.
Input parameters
The stream's UUID or name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_STREAMSTool to list all streams in your Faraday account. Use when you need to retrieve event streams associated with the account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_STREAMS_ANALYSISTool to get the count of stream events emitted over a time period. Use when you need to analyze stream activity patterns and event volume trends.
Input parameters
The UUID of a stream or stream name
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_TARGETTool to retrieve a specific target by its UUID from Faraday. Use when you need to fetch details about a target including its configuration, status, and export settings.
Input parameters
The UUID of the target to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_TARGETS_ANALYSISTool to retrieve a target's analysis including geographic distributions and trait breakdowns. Use when you need to understand the composition and characteristics of individuals within a specific target.
Input parameters
The UUID of the target to retrieve analysis for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_TRAITTool to retrieve a specific trait by ID. Use when you need to get detailed information about a trait including its type, category, statistical properties, and configuration.
Input parameters
The UUID of the trait to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_TRAITS_ANALYSIS_DIMENSIONSTool to retrieve the percentage of the US population that falls into each category of a trait. Use when you need to analyze the distribution of a specific trait across the population.
Input parameters
The UUID of the trait to retrieve analysis dimensions for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_TRAITS_CSVTool to retrieve all user-defined and Faraday-provided traits in CSV format. Use when you need to export or analyze trait data in a spreadsheet-compatible format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_UPLOADTool to download a previously uploaded file from a Faraday dataset directory. Use when you need to retrieve the contents of a specific file.
Input parameters
The name of an individual data file in a dataset to download. Must include the file extension (e.g., '.csv', '.json'). Example: 'data_01.csv', 'sample.csv'
A directory of files which can be imported as a single dataset. This is the folder name where the file is stored. Example: 'abc_orders', 'test-data'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_UPLOADSTool to retrieve the list of previously uploaded files in Faraday. Use when you need to see uploaded datasets or verify file uploads.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_USAGESTool to retrieve usage statistics for your Faraday account. Use when you need to check current usage and limits for various account features.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_WEBHOOK_ENDPOINTTool to retrieve a webhook endpoint by its UUID. Use when you need to access details about a specific webhook endpoint including its URL, status, enabled events, and signing secret.
Input parameters
The UUID of a webhook endpoint
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_GET_WEBHOOK_ENDPOINTSTool to list all webhook endpoints configured for the account. Use when you need to retrieve webhook endpoint information including URLs, status, and enabled events.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_LIST_ATTRIBUTESTool to list all attributes in the feature store. Use when you need to retrieve the catalog of available attributes for data analysis or feature engineering.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_LIST_CONNECTIONSTool to list all connections configured in Faraday. Use when you need to view available data connections between Faraday and external locations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_LIST_SCOPESTool to list all scopes. Use when you need to retrieve scope configurations for viewing output data instructions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_LIST_TARGETSTool to list all targets in your Faraday account. Use when you need to view export configurations for predictions.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_COHORTTool to unarchive a previously archived cohort. Use when you need to restore an archived cohort and optionally its upstream resources.
Input parameters
The UUID of the cohort to unarchive. Example: 'bc4eef1c-be49-4ca6-880f-a34479c7755d'
Only allow the following resources (by UUID) to be unarchived. If an upstream resource would be unarchived and is not in this list, throw an error.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_DATASETSTool to unarchive a dataset in Faraday. Use when you need to restore an archived dataset for active use. Optionally cascades to upstream resources.
Input parameters
Only allow the following resources to be archived/unarchived. If a downstream or upstream resource would be archived/unarchived, and is not in this list, throw an error.
The UUID of the dataset to unarchive.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_OUTCOMETool to unarchive an outcome in Faraday. Use when you need to restore updates to a previously archived outcome.
Input parameters
Only allow the following resource UUIDs to be unarchived. If an upstream resource would be unarchived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
The UUID of the outcome to unarchive. Unarchiving restores updates to the outcome. Example: '15be73ec-1525-4d5c-a96a-e644c93d00d8'
When true, unarchive the outcome and all its upstream resources. When false, throw an error if there are upstream resources that would be unarchived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_PERSONA_SETSTool to unarchive a previously archived persona set. Use when you need to restore an archived persona set and optionally its upstream resources.
Input parameters
Only allow the following resources (by UUID) to be unarchived. If an upstream resource would be unarchived and is not in this list, throw an error.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
The UUID of the persona set to unarchive. Example: '8505e525-128c-4ede-a279-85f372aa6aaf'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_PLACESTool to unarchive a previously archived place. Use when you need to restore an archived place and optionally its upstream resources.
Input parameters
The UUID of the place to unarchive. Example: 'a1eafa5c-020a-427f-ae18-2d0b3c0fced7'
Only allow the following resources (by UUID) to be unarchived. If an upstream resource would be unarchived and is not in this list, throw an error.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_SCOPETool to unarchive a previously archived scope. Use when you need to restore an archived scope and optionally its upstream resources.
Input parameters
The UUID of the scope to unarchive. Example: 'fce4d114-9516-4e8c-a92e-e1ed13d5369d'
Only allow the following resource UUIDs to be unarchived. If an upstream resource would be unarchived and is not in this list, an error will be thrown. Cannot be used together with cascade_to_all.
When true, unarchive the scope and all its upstream resources. When false, throw an error if there are upstream resources that would be unarchived. Cannot be used together with cascade_to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_STREAMTool to unarchive a stream in Faraday. Use when you need to restore an archived stream for active use. Optionally cascades to upstream resources.
Input parameters
Only allow the following resources to be unarchived. If an upstream resource would be unarchived, and is not in this list, throw an error.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
The UUID or name of the stream to unarchive.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UNARCHIVE_TRAITTool to unarchive a trait. Use when you need to restore an archived trait and optionally its upstream resources.
Input parameters
The UUID of the trait to unarchive
Only allow the following resource UUIDs to be unarchived. If an upstream resource would be unarchived, and is not in this list, throw an error.
When unarchiving a resource, if this is set to true, unarchive the resource and all its upstream resources. If false, and there are upstream resources that would be unarchived, throw an error.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_ACCOUNTTool to update an account's name or branding settings. Use when you need to modify account properties using JSON Merge Patch semantics.
Input parameters
The name of the account. Must be non-empty and max 64 characters.
Whitelabel branding configuration for the account
The UUID of the account to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_COHORTTool to update a cohort's configuration using JSON Merge Patch semantics. Use when you need to modify cohort properties like name, filters, or conditions.
Input parameters
Human-readable label for this cohort. Must be non-empty and max 64 characters.
List of traits to filter cohort membership. Set to null to clear.
Whether to show the Cohort in Explore, the map view on https://app.faraday.ai. This will slow down Cohort builds.
Recency condition for event-based filtering.
The UUID of the cohort to update
Max count for this cohort's config
Max value for this cohort's config
Min count for this cohort's config
Min value for this cohort's config
The name field of the stream from which to build this cohort. Set to null to clear.
List of places to use to spatially filter Cohort membership. Set to null to clear.
List of stream properties to filter cohort membership on. The stream properties must be for the same stream set as the cohort stream_name. Nulls are excluded unless explicitly requested with _null: true. Set to null to clear.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_CONNECTIONTool to update a Faraday connection's name or options. Use when you need to modify connection properties using JSON Merge Patch semantics.
Input parameters
A user-friendly name of the connection. Max 64 characters, must be non-empty.
Connection-specific options that vary by connection type.
The UUID of the connection to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_DATASETTool to update a dataset configuration using JSON Merge Patch semantics. Use when you need to modify dataset properties like name, identity sets, output configurations, or privacy settings.
Input parameters
An identifying name for this dataset.
Dataset connection options. Must specify 'type' field for the connection type.
A dataset in preview mode will only detect columns and produce a data preview, but not ingest the data. Set to null to clear.
Privacy settings: 'suppress' (data can be used for modeling but excluded from pipelines) or 'delete' (data cannot be used for modeling and excluded from pipelines). Set to null to clear.
The UUID of the dataset to update.
A mapping of identity set names to identity set objects. Describes all the logical groupings of personally-identifiable information present in the dataset. Set value to null to clear.
Also known as the "primary key" of the dataset. A column or set of columns that uniquely identify an input row. Set to null to clear.
A mapping of trait name to trait definition. Set to null to clear.
Describes how to transform the dataset into one or more streams. Set to null to clear.
Which identity providers to use for matching, in order of priority. Set to null to clear.
A column specifying a date associated with a record. Set to null to clear.
Deprecated: use reference_key_columns instead. The name of the column that references an ID from an external system. Set to null to clear.
The names of columns that reference IDs from an external system. Set to null to clear.
An array-based approach to transforming datasets into streams. Each element specifies a stream_name and properties configuration. Set to null to clear.
If specified, all columns that are not excluded will be output as traits. Must include 'exclude' field with list of column names. Set to null to clear.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_OUTCOMETool to update an outcome's configuration using JSON Merge Patch semantics. Use when you need to modify outcome properties such as name, cohorts, bias mitigation, feature blocklist, prediction mode, predictors, or preview status.
Input parameters
Human-readable label for this outcome. Each outcome must have a unique name. Max 64 characters, must not be empty or only whitespace.
An outcome in preview mode will not build until preview is turned off. Set to null to clear.
The UUID of the outcome to update.
Configuration for features used during modeling.
Bias mitigation configuration for age and gender dimensions.
Prediction mode for outcome modeling.
Field or category names that should not be considered for this outcome, primarily for Responsible AI purposes. Set to null to clear.
A cohort of people who could attain or attrite the desired outcome. If not specified, uses the US population. Set to null to clear.
A cohort of counterexamples - people who have clearly failed to attain the outcome. This cohort is optional. Set to null to clear.
A cohort of people who have attained the desired outcome (e.g., existing customers if predicting prospect to customer transition).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_PERSONA_SETTool to edit a persona set's configuration using JSON Merge Patch. Use when you need to update persona set properties like name, explore visibility, number of clusters, or preview mode.
Input parameters
Human-readable label for this persona set. Must be non-empty and max 64 characters.
Whether to show the persona set in Explore, the map view on https://app.faraday.ai. This will slow down persona set builds. Set to null to clear this setting.
A persona set in preview mode will not build until preview is turned off. Set to null to clear this setting.
The UUID of the persona set to update
Specify the exact number of clusters (i.e. personas) in the persona set. By default, the optimal value is determined automatically. Setting this requires external knowledge and should only be done when the use-case necessitates a specific number. Set to null to clear and use automatic determination.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_PLACETool to update a place's name, addresses, or geojson geometry. Use when you need to modify place properties using JSON Merge Patch semantics.
Input parameters
Human-readable label for this place. Names must be unique. Uniqueness is case-insensitive.
A GeoJSON Geometry, as defined in the GeoJSON specification. The longitude and latitude units are in decimal degrees, using the WGS84 coordinate reference system (SRID 4326). Set to null to clear geojson.
The UUID of the place to update
List of addresses to be geocoded. Set to null to clear addresses, or provide a list to overwrite existing addresses.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_SCOPETool to update a Faraday scope's configuration using JSON Merge Patch semantics. Use when you need to modify scope properties such as name, payload settings, population cohorts, or preview status.
Input parameters
Human-readable label for this scope. Each scope must have a unique name (max length: 64 characters, must be non-empty).
The data to include for each person in this scope (for PATCH requests)
A preview scope provides only a limited number of output records, but it is not billed.
The UUID of the scope to update
The people to include in a scope (for PATCH requests)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_STREAMTool to update a stream's properties using JSON Merge Patch semantics. Use when you need to modify stream metadata like description, category, or deprecation status.
Input parameters
A billing tier for the stream property. Set to null to clear this field.
A category describing the type of stream property. Set to null to clear this field.
A human-readable name for the stream. Set to null to clear this field.
Whether the stream is deprecated. Set to null to clear this field.
Columns in your data that you want to associate with this event. The key is the name of the property, and the value is metadata about the property. Set to null to clear this field.
A description of the stream. Set to null to clear this field.
Notes about the deprecation of the stream. Set to null to clear this field.
The stream's UUID or name to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_TARGETTool to update a target's configuration in Faraday. Use when you need to modify target properties using JSON Merge Patch semantics.
Input parameters
A user-friendly name of the target (max length: 64 characters)
Limit configuration for target rows
Filter configuration for target rows
Target export configuration options
The UUID of the target to update
Deprecated: use custom_structure. Explicit mapping of columns that should be included in the target export. Set to null to clear
If this is a replication (externally-hosted) target, the UUID of a connection. Set to null to clear
Whether to use human-readable column names instead of machine-readable format with underscored uuids. Set to null to clear
Target representation configuration
Configuration for the analysis of the target
Custom structure transformations to override the default selection, order, and name of exported columns. Set to null to clear
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_TRAITTool to update a trait's properties using JSON Merge Patch semantics. Use when you need to modify trait metadata like description, literate name, lookup table, statistical type, or unit.
Input parameters
For numeric types, in what units is the data stored. Set to null to clear this value.
A more human-consumable version of the name of this field. Set to null to clear this value.
The UUID of the trait to update
Information about this field. Set to null to clear this value.
A mapping of the input values used in modeling, to how they should be displayed in reports. Set to null to clear this value.
Statistical type describing the nature of data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FARADAY_UPDATE_WEBHOOK_ENDPOINTSTool to update a webhook endpoint's configuration. Use when you need to modify the status, URL, or enabled events for an existing webhook endpoint.
Input parameters
The URL of the webhook endpoint.
The status of the webhook endpoint.
The event types to enable for this endpoint. Available events: 'resource.errored' (when a resource encounters an error) and 'resource.ready_with_update' (when a resource is ready with updates).
The UUID of the webhook endpoint to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 44 agents privately built on Nagent that already use Faraday.
Build on Nagent
Connect Faraday to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Faraday, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Faraday is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Faraday is connected, you configure its 117 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Faraday steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Faraday event fires, the agent kicks off automatically.
Every Faraday action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Faraday ships with 117 pre-built artificial intelligence actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Faraday together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Faraday-based workflows tailored to your business.