Faraday

117 tools available

Faraday lets you embed AI in workflows throughout your stack—to make your favorite tools perform even better

Connect Faraday to Definable to route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas call Faraday's 117 tools directly from chat or scheduled flows. Add it to your persona's available models and route requests to it where it fits best.

Common workflows with Faraday

Multi-provider routing

Persona decides which model fits
Calls this provider when its strengths apply
Falls back to alternatives on rate-limits

Specialised pipeline

Use this provider for one stage
Pipe to a different model for the next
Combine outputs in the response

Faraday actions 117

Every Faraday action below is a callable tool any Definable persona can invoke.

Archive Cohort

Tool to archive a cohort in Faraday. Use when you need to stop updates to a cohort while keeping it visible.

Archive Connection

Tool to archive a connection in Faraday. Use when you need to stop updates to a connection while keeping it visible.

Archive Dataset

Tool 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.

Archive Outcome

Tool to archive an outcome in Faraday. Use when you need to stop updates to an outcome while keeping it visible.

Archive Persona Set

Tool to archive a persona set in Faraday. Use when you need to stop updates to a persona set while keeping it visible.

Archive Place

Tool to archive a place in Faraday. Use when you need to stop updates to a geospatial area or address set while keeping it visible.

Archive Scope

Tool to archive a scope in Faraday. Use when you need to stop updates to a scope while keeping it visible.

Archive Stream

Tool 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.

Archive Target

Tool 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.

Archive Trait

Tool to archive a trait in Faraday. Use when you need to stop updates to a trait while keeping it visible.

Create Account

Tool to create a new Faraday account with specified name and branding. Use when you need to provision a new account in Faraday.

Create Cohorts

Tool 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.

Create Dataset

Tool to create a new dataset in Faraday. Use when you need to define a new data source for analysis and predictions.

Create Outcome

Tool 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.

Create Persona Set

Tool 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.

Create Place

Tool 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.

Create Scope

Tool 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.

Create Stream

Tool to create a new stream or find an existing stream by name. Use when you need to initialize a stream for event data collection.

Create Target Preview

Tool to start a preview delivery for a target. Use when you need to initiate a preview of target data before full deployment.

Create Target

Tool 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.

Create Trait

Tool 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.

Create Webhook Endpoint

Tool 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.

Delete Account

Tool 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.

Delete All Orphaned Traits

Tool to delete all orphaned traits from Faraday. Use when you need to clean up traits that are not associated with any source dataset.

Delete Cohort

Tool to permanently delete a cohort from Faraday. Use when you need to remove a cohort that is no longer needed.

Delete Connection

Tool to delete a Faraday connection by its UUID. Use when you need to permanently remove a connection.

Delete Dataset

Tool 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.

Delete Outcome

Tool to delete an outcome by its UUID. Use when you need to remove an outcome from Faraday.

Delete Persona Set

Tool 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.

Delete Place

Tool to delete a place by its UUID. Use when you need to remove a place from the system.

Delete Scope

Tool 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.

Delete Stream

Tool to delete a stream by its UUID or name. Use when you need to remove a stream that is no longer needed.

Delete Target

Tool to delete a target by its UUID. Use when you need to remove a target from Faraday.

Delete Upload

Permanently 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.

Delete Webhook Endpoint

Tool 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.

Force Update Cohort

Tool to trigger a rerun for a cohort. Use when you need to force rebuild a cohort's data.

Force Update Connection

Tool to trigger a rerun for a Faraday connection. Use when you need to force refresh connection data.

Force Update Dataset

Tool 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.

Force Update Outcome

Tool 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.

Force Update Persona Set

Tool 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.

Force Update Place

Tool to trigger a rerun for a place. Use when you need to force rebuild a place's data.

Force Update Scope

Tool 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.

Force Update Stream

Tool to trigger a rerun for a stream. Use when you need to force rebuild a stream's data.

Force Update Target

Tool to trigger a rerun for a target. Use when you need to force rebuild a target's data.

Force Update Trait

Tool to trigger a rerun for a trait. Use when you need to force rebuild a trait's data.

Get Account

Tool to retrieve detailed information about a Faraday account by its UUID. Use when you need to fetch account details, status, branding, or billing information.

List Accounts

Tool 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.

Get Accounts Billing

Tool to get billing information about your account. Use when you need to retrieve invoices, payments, or usage information for a specific account.

Get Cohort

Tool to retrieve a specific cohort by ID. Use when you need to fetch details about a specific cohort.

Get Cohort Membership Analysis

Tool 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.

List Cohorts

Tool to list all cohorts in your Faraday account. Use when you need to retrieve the list of customer groups or segments.

Get Connection Datasets

Tool to retrieve all datasets that use a specific connection. Use when you need to list datasets associated with a connection ID.

Get Connection Targets

Tool 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.

Get Current Account

Tool 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.

Get Current Account Billing

Tool to retrieve billing information about the current account. Use when you need to check invoices, payments, or usage limits for the authenticated Faraday account.

Get Dataset

Tool 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.

Get Dataset Ingress Logs

Tool 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.

List Feature Stores

Tool to list all feature stores. Use when you need to retrieve feature stores from your Faraday account.

Get Dependency Graph

Tool to retrieve the complete dependency graph for all resources on an account. Shows relationships between datasets, cohorts, outcomes, targets, connections, and other resources.

Get Market Opportunity Analyses

Tool to retrieve all market opportunity analyses from Faraday. Use when you need to view penetration and opportunity metrics in your market.

Get Outcome

Tool 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.

List Outcomes

Tool 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.

Get Persona Set

Tool 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.

Get Persona Set Analysis Flow

Tool 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.

List Persona Sets

Tool to list all persona sets. Use when you need to retrieve customer persona sets for analysis or selection.

Get Persona Set Analysis Dimensions

Tool 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.

Get Place

Tool 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.

List Places

Tool 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.

List Recommenders

Tool to list all recommenders. Use when you need to retrieve recommender resources that predict future associations based on event streams.

Get Scope

Tool 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.

Get Scope Analysis

Tool 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.

Get Scope Datasets

Tool 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.

Get Scope Efficacy

Tool to retrieve efficacy metrics for a scope. Returns model performance metrics and accuracy measurements showing how well predictions performed over time.

Get Scope Payload Cohorts

Tool 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.

Get Scope Payload Outcomes

Tool to retrieve payload outcomes for a specific scope. Use when you need to fetch the outcome predictions included in a scope's data payload.

Get Scope Payload Persona Sets

Tool 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.

Get Scope Payload Recommenders

Tool to retrieve payload recommenders for a specific scope. Use when you need to fetch recommender resources associated with a scope's payload configuration.

Get Scope Population Exclusion Cohorts

Tool 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.

Get Scope Population Cohorts

Tool to get population cohorts for a specific scope. Use when you need to retrieve the list of cohorts associated with a scope's population.

Get Scope Targets

Tool to get all targets for a specific scope. Use when you need to retrieve export configurations and target details for a scope.

Get Stream

Tool to retrieve a stream by its UUID or name. Use when you need to fetch stream details including properties, event counts, and metadata.

List Streams

Tool to list all streams in your Faraday account. Use when you need to retrieve event streams associated with the account.

Get Streams Analysis

Tool 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.

Get Target

Tool 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.

Get Target Analysis

Tool 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.

Get Trait

Tool 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.

Get Trait Analysis Dimensions

Tool 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.

Get Traits CSV

Tool 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.

Get Upload

Tool to download a previously uploaded file from a Faraday dataset directory. Use when you need to retrieve the contents of a specific file.

List Uploaded Files

Tool to retrieve the list of previously uploaded files in Faraday. Use when you need to see uploaded datasets or verify file uploads.

Get Usages

Tool to retrieve usage statistics for your Faraday account. Use when you need to check current usage and limits for various account features.

Get Webhook Endpoint

Tool 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.

List Webhook Endpoints

Tool to list all webhook endpoints configured for the account. Use when you need to retrieve webhook endpoint information including URLs, status, and enabled events.

List Attributes

Tool 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.

List Connections

Tool to list all connections configured in Faraday. Use when you need to view available data connections between Faraday and external locations.

List Scopes

Tool to list all scopes. Use when you need to retrieve scope configurations for viewing output data instructions.

List Targets

Tool to list all targets in your Faraday account. Use when you need to view export configurations for predictions.

Unarchive Cohort

Tool to unarchive a previously archived cohort. Use when you need to restore an archived cohort and optionally its upstream resources.

Unarchive Dataset

Tool to unarchive a dataset in Faraday. Use when you need to restore an archived dataset for active use. Optionally cascades to upstream resources.

Unarchive Outcome

Tool to unarchive an outcome in Faraday. Use when you need to restore updates to a previously archived outcome.

Unarchive Persona Set

Tool to unarchive a previously archived persona set. Use when you need to restore an archived persona set and optionally its upstream resources.

Unarchive Place

Tool to unarchive a previously archived place. Use when you need to restore an archived place and optionally its upstream resources.

Unarchive Scope

Tool to unarchive a previously archived scope. Use when you need to restore an archived scope and optionally its upstream resources.

Unarchive Stream

Tool to unarchive a stream in Faraday. Use when you need to restore an archived stream for active use. Optionally cascades to upstream resources.

Unarchive Trait

Tool to unarchive a trait. Use when you need to restore an archived trait and optionally its upstream resources.

Update Account

Tool to update an account's name or branding settings. Use when you need to modify account properties using JSON Merge Patch semantics.

Update Cohort

Tool to update a cohort's configuration using JSON Merge Patch semantics. Use when you need to modify cohort properties like name, filters, or conditions.

Update Connection

Tool to update a Faraday connection's name or options. Use when you need to modify connection properties using JSON Merge Patch semantics.

Update Dataset

Tool 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.

Update Outcome

Tool 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.

Update Persona Set

Tool 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.

Update Place

Tool to update a place's name, addresses, or geojson geometry. Use when you need to modify place properties using JSON Merge Patch semantics.

Update Scope

Tool 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.

Update Stream

Tool 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.

Update Target

Tool to update a target's configuration in Faraday. Use when you need to modify target properties using JSON Merge Patch semantics.

Update Trait

Tool 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.

Update Webhook Endpoint

Tool to update a webhook endpoint's configuration. Use when you need to modify the status, URL, or enabled events for an existing webhook endpoint.

Frequently asked questions

What can I automate with Faraday on Definable?

Anything Faraday exposes through its API. Common artificial intelligence workflows on Definable include route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas can call any of the 117 Faraday tools directly, then chain the result into another integration without you writing code.

How does Faraday authentication work?

Faraday uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Faraday integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 117 Faraday tools. You only need a separate Faraday subscription if Faraday itself charges per seat or per API call.

Is using Faraday through Definable secure?

Every call from a persona to Faraday is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Faraday on Definable?

Sign up for Definable, open the integrations page, find Faraday, and connect via OAuth or API key. You can immediately attach Faraday to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Faraday actions does Definable expose?

Definable exposes all 117 Faraday actions as callable tools — including `Archive Cohort`, `Archive Connection`, `Archive Dataset`, plus 114 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Faraday?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations