Skip to navigation
Troubleshooting & FAQ

FAQ

Find answers about getting started, billing, building, data, integrations, security, and support.

Getting started

Do I need my own AI API keys?

No. Use Runtype platform keys without setting up provider accounts. Connect your own provider credentials on the Team plan or higher when you need dedicated provider limits, direct provider billing, or additional supported models.

How long does it take to build a working Flow?

Build time depends on the steps and integrations that your Flow uses. Follow the Quickstart: Social Media Post Generator to build a two-step Flow, attach it to a Product, and expose it through a REST API Surface.

Use Agent and Flow templates when you want a configured starting point. Review the template steps, then customize and test the Flow.

Can I use Runtype without coding?

Yes. Use the dashboard editors and configuration panels to build Flows, Products, Surfaces, and Evals without writing code. Some advanced options, such as the Run Code step and code-authored Tools, require JavaScript.

How do I add teammates?

An organization admin opens Settings > Team and clicks Invite Member. Only admins can manage billing, invite and remove members, and change the organization’s provider API keys. For roles and the invitation steps, see Team members and permissions.

Pricing and billing

What’s included in the Launch plan?

The Launch plan is free and pay as you go, with $5 in one-time signup credit. It includes the following:

  • Platform keys with shared rate limits. BYOK is not available on this plan.
  • Unlimited executions (Flow and Agent runs).
  • Unlimited Surfaces.
  • Unlimited team members.
  • One day of log retention.
  • Prepaid credits with automatic top-up.

Some new accounts start with a free trial. The number of executions is unlimited, whether or not you have a payment method on file. Credit, automatic top-up, and your spend cap control whether new executions can start. Test API keys have their own daily and lifetime execution limits. For details, see Rate limits and usage. To compare plans, see Billing and plans.

How does billing work for AI models?

When you use platform keys, Runtype bills model and built-in Tool usage from prepaid credits. To review Runtype-billed usage, open Settings > Usage. For more information, see Usage data. When you use BYOK, your AI provider bills you directly for model costs.

Can I cancel anytime?

Yes. Cancel your subscription from Settings > Billing. You keep your plan features through the end of the billing period. After that period ends, your account returns to the Launch plan, and your Flows, Records, and configuration remain available.

Flows and agents

What’s the difference between a Flow and an Agent?

A Flow runs the steps and branches that you configure. Use a Flow when you can define the required sequence before each run.

An Agent uses a model to select tools and sequence calls based on a goal and the available context. Use an Agent when the next action depends on the task or earlier results. For help deciding, see Choosing between a flow and an agent.

Can I reuse a Flow across multiple Products?

Yes. Attach one Flow as a Capability in multiple Products. Each Product stores its own Capability name and description. Saved changes to the Flow apply to every Product that uses it.

How do I reduce Flow latency and cost?

The following practices reduce latency and cost:

  • Choose a model that fits the task. For high-volume steps, consider gpt-5.4-nano or claude-haiku-4-5.
  • Keep prompts focused on the required information.
  • Process only the data that each step needs.
  • Run an Eval to compare model settings by latency, cost, and output quality.

Products, Surfaces, and Capabilities

What’s the relationship between Products, Surfaces, and Capabilities?

Products, Capabilities, and Surfaces relate as follows:

  • A Product groups Flows and Agents as Capabilities and connects them to Surfaces.
  • A Capability is a Flow, Agent, or external Agent that a Product exposes.
  • A Surface exposes Capabilities through an interface such as a chat widget, REST API, MCP server, or messaging channel.

Add multiple Surfaces to one Product. Reuse a Capability across multiple Surfaces when you need the same behavior in different interfaces.

Can I have multiple Surfaces on one Product?

Yes. Add multiple Surfaces to one Product, including a chat widget, REST API, Slack channel, MCP server, or other supported interface.

How do I update a deployed Product?

Edit the linked Flow or Agent. Test your changes in the editor before you save.

Save records the Flow configuration. Publish that saved version to change what Products run. If publication fails, the previous live version stays active. A Flow with no publication, or a legacy publication created before this saved-version model, uses its current saved definition until you explicitly publish. For an Agent, your organization’s live-default setting decides whether a save or a publish to live changes what Products run.

For details, see Product versioning and status, Flow versioning and publishing, and Agent versioning and publishing.

Can I embed the chat widget on my own website?

Yes. Embed the chat widget on any website that you control with the generated script tag or React code. The widget sends requests to the endpoint that Runtype generates for the Surface.

Add your site’s origin to the allowed origins of the widget’s client token. Otherwise, the widget’s requests fail with 403 and Origin not allowed. For more information, see Client tokens and domain restrictions.

To ask about a custom API domain, contact sales@runtype.com.

Records and data

What are Records?

Records store structured data that your Flows and Agents use as context. Each Record includes name, type, metadata, and id. The metadata field stores a JSON object that can contain your application data.

Can I import existing data?

Yes. On the Records page, select Create Record, then select Import CSV file. Map the CSV columns to each Record’s type and name, review the preview, and upload the file. Runtype imports the remaining CSV fields as metadata.

Can I export my data?

Yes. The dashboard exports the following data:

  • Records: On the Records page, click Export to download the matching Records as a CSV file. For more information, see Search, filter, and export Records.
  • Flows: On the Flows page, use the Export action on a Flow to download a JSON file that Import flow accepts. For more information, see Duplicate, export, or delete a flow.
  • Logs: In the log viewer, click Export, then select Export as CSV or Export as JSON. For more information, see Export logs.

To run exported Flows and Agents on your own infrastructure, see Can I self-host Runtype?.

How does search work with Records?

Use exact filters, semantic search, or both to find Records. Exact filters match Record fields. Semantic search uses vector embeddings to find Records with related meaning instead of exact keywords. Read Filtering and searching records for search options.

Evals and testing

What are Evals?

Use Evals to compare model, prompt, and step configurations with the same test inputs. Review output, success rate, latency, cost, and token usage before you change a Flow.

How many Evals can I run?

Your plan sets a daily Eval limit. Each submission counts once, regardless of how many configurations or Records it includes. The Evals page shows your usage and the limit. The count resets at midnight UTC.

When you reach the limit, the Eval does not start, and the API returns 402 with the code DAILY_EVAL_LIMIT. For more information, see Eval limits.

Integrations

Which integrations are available?

Runtype supports integrations including Slack, Google Workspace, GitHub, Linear, PostHog, Braintrust, Firecrawl, Exa, Cloudflare Browser Rendering, Weaviate, Cloudflare Vectorize, Daytona, Granola, Orthogonal, and Resend.

Where you connect an integration depends on the service:

  • Settings > Integrations: Google Workspace, Granola, Orthogonal, analytics and tracing services, web scraping and search services, vector databases, code execution (Daytona), and email (Resend).
  • Slack: Connect your Slack workspace when you set up a Slack Surface. For more information, see Slack integration.
  • GitHub and Linear: Connect them from an Agent’s or prompt step’s tool picker. For more information, see GitHub integration and Linear integration.

You can also connect custom MCP servers and create Tools that call external APIs. For AI provider connections, see Connecting AI model providers.

Can I request new integrations?

Yes. Email your request to support@runtype.com. Enterprise plans include custom integrations.

Security and privacy

Is my data secure?

Runtype encrypts data in transit with TLS and encrypts sensitive fields at rest. Stored provider API keys, Secrets, and integration credentials use AES-256-GCM encryption. For security and compliance information, see the Runtype security page.

Do you train AI models on my data?

Runtype does not train AI models on your data. Runtype sends each request to the model or Tool provider that your Flow or Agent selects. When you use BYOK, the provider’s terms with you govern that content. Read Model routing and data flow to review which companies can process your prompts.

Can I delete my data?

Delete individual Flows and Records from their dashboard pages. To request account deletion or other data removal, email support@runtype.com.

Technical

Is there an API?

Yes. Use the Runtype API to manage Flows, Agents, Products, Surfaces, Records, Evals, Schedules, and other resources. Runtype provides SDKs for TypeScript, Python, Ruby, and Java, and the runtype CLI (@runtypelabs/cli).

API and SDK requests authenticate with an API key. To create one, see Managing API keys. To manage Runtype from a coding agent through the Runtype MCP server, see Connect Runtype to coding agents.

Can I schedule Flows to run automatically?

Yes. Use Schedules to run Flows and Agents once or on a recurring cadence. Your plan determines the schedule frequency and the active schedule limit.

If a new schedule exceeds a limit, the request fails with 402 and the code ACTIVE_SCHEDULE_LIMIT or SCHEDULE_FREQUENCY_LIMIT. Pause another schedule, choose a slower cadence, or upgrade your plan.

Can I self-host Runtype?

Self-hosting, also called bring your own cloud (BYOC), requires the Enterprise plan. Read Self-hosting (BYOC) for the supported workflow.

Support

How do I get help?

The following resources help you resolve problems:

Do you offer onboarding or training?

To discuss onboarding and training options, email sales@runtype.com.

Next steps