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.

Pricing and billing

What’s included in the Launch plan?

The Launch plan is free. It includes the following features:

  • A 0pay−as−you−goplanwitha14−daytrialand0 pay-as-you-go plan with a 14-day trial and 5 in signup credit.
  • Platform keys with shared rate limits. BYOK is not available on this plan.
  • Unlimited Flow executions.
  • Unlimited Surfaces.
  • Unlimited team members.
  • 1 day of log retention.
  • Prepaid credits with auto-top-up.

Review Billing and plans for plan features and usage controls.

Flow execution count is unlimited, whether or not you have a payment method on file. Credits, auto-top-up, and spend caps control whether new executions can start. Read Rate limits and usage for details.

How does billing work for AI models?

When you use platform keys, Runtype bills model and built-in Tool usage from prepaid credits. Review Runtype-billed usage in Settings → Usage. 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?

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

Agents use 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.

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. Changes to the Flow apply to every Product that uses it.

How do I make Flows faster?

Use these practices to reduce latency or 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.
  • Use Evals to compare model settings by latency, cost, and output quality.

Products, Surfaces, and Capabilities

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

Use these definitions:

  • 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 and test the linked Flow or Agent, then publish the version that you want the Product to use. Products use the published version of each Flow and Agent Capability. Read Product versioning and status for details.

Can I use my own domain for the chat widget?

Yes. Embed the chat widget on your domain with the generated script or React code. The widget sends requests to the endpoint that Runtype generates for the Surface. Contact sales@runtype.com about custom API domain options.

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.

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 the daily Eval limit. Open Settings → Billing to review plan details and limits.

Integrations

Which integrations are available?

Runtype supports integrations for Slack, Google Workspace, Linear, GitHub, Weaviate, Firecrawl, Exa, and PostHog. Configure supported connections in Settings → Integrations. You can also connect custom MCP servers and create Tools that call external APIs.

For AI provider connections, read Connecting AI model providers.

Can I request new integrations?

Yes. Email support@runtype.com with your request. 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. API keys use AES-256-GCM encryption. Review the Runtype security page for security and compliance information.

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. Contact support@runtype.com to request account deletion or other data removal. Deleted data is permanently removed within 30 days.

Technical

Is there an API?

Yes. Use the Runtype API to manage Flows, Agents, Tools, Records, Products, API keys, Model Configs, and Secrets. Use the Runtype SDK to work with Runtype from TypeScript.

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 active schedule limit.

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?

Use these support options:

  • Search these docs for product instructions.
  • Email support@runtype.com for assistance.
  • If you have an Enterprise plan, use priority support.

Do you offer onboarding or training?

Contact sales@runtype.com to discuss onboarding and training options.

If you don’t find an answer, email support@runtype.com.

Next steps

Use these pages to continue: