Relayna logo Relayna

Frequently Asked Questions

Everything you need to know about integrating human approval and secure file handoffs into your AI workflows.

General

What is Relayna?

Relayna is an API that adds human-in-the-loop (HITL) approval checkpoints and secure file handoffs to AI agent workflows. It allows agents to pause execution, request human review via a magic link, and automatically resume via webhooks once a decision is made.

Why use Relayna instead of Amazon S3 or Cloudflare R2?

Unlike basic cloud storage, Relayna is a stateful workflow coordinator. While it uses Cloudflare R2 for secure file storage, it also provides a built-in reviewer UI, manages approval states (pending, approved, rejected), and triggers webhooks to resume your AI agent.

What is the difference between Relayna and tools like Webhook.site or RequestBin?

While tools like Webhook.site are built for inspecting raw payloads, Relayna is a workflow orchestrator. Relayna not only catches webhooks but also provides a polished, secure UI for human reviewers, manages the approval state machine (Approved/Rejected), and fires a return webhook to your system to trigger the next step in your automation.

Can Relayna be used for secure file sharing without human review?

Yes. You can use the Relayna Assets API as a standalone secure file relay. Agents can upload files, set an automatic expiration time (TTL), and generate temporary presigned URLs to share files with users or other agents without creating a review checkpoint.

Is there a demo I can see?

Yes! You can see exactly what a reviewer sees on our interactive demo page.

Reviewers & Security

Do human reviewers need to create a Relayna account?

No. Reviewers do not need an account. They access review checkpoints using secure, token-based magic links. This allows anyone to approve or reject an AI agent's action with zero friction.

How does Relayna secure uploaded files?

Relayna secures files by storing them encrypted-at-rest on Cloudflare R2 and restricting access to temporary, presigned URLs. You can also configure a Time-to-Live (TTL) so that files automatically expire and are deleted after a set period.

Is Relayna GDPR compliant for processing sensitive agent-generated files?

Relayna is designed with security-first principles. All files are encrypted-at-rest and served via temporary URLs. We offer configurable Time-to-Live (TTL) settings so that sensitive files (like invoices or logs) are automatically deleted from our servers immediately after review or after a set period, supporting data minimization requirements.

How can I revoke access to a shared file or review link?

You can instantly revoke access by using the Relayna API to cancel the review checkpoint or revoke the specific review link. Once revoked, the magic link and any associated file URLs will immediately return a 404 error.

Integration

How do I add a human approval step to an n8n AI workflow?

You can integrate Relayna into n8n using the HTTP Request node to create a checkpoint and the Webhook node to receive the approval callback. This allows your n8n workflow to pause mid-execution, wait for a human to review data via a magic link, and resume automatically once the decision is received.

Can I use Relayna with Claude Code, Cursor, or other CLI-based AI agents?

Yes. Because Relayna is a standard REST API, you can add it as a tool or function to any CLI-based agent. Simply provide the agent with our OpenAPI specification, and it can autonomously upload files and request human review when it reaches a high-stakes decision point.

How can I automatically generate a type-safe client for the Relayna API?

You can use our OpenAPI spec (available at /api/json/open_api) with tools like openapi-generator, fern, or pydantic-codegen. This allows you to generate native Python, TypeScript, or Go clients instantly, ensuring your integration is type-safe and consistent with our latest API version.

What programming languages and AI frameworks does Relayna support?

Relayna is a language-agnostic REST API. It works with any language (Python, TypeScript, Go) and any AI framework (LangChain, AutoGPT, n8n). We also provide an OpenAPI specification so you can automatically generate native clients or feed it directly into LLM tool-calling arrays.

How does my AI agent know when a human has approved a request?

Relayna primarily uses webhooks to notify your system in real-time. When a reviewer makes a decision (approved, rejected, or changes requested), Relayna sends a POST request with the decision payload to your configured callback URL. Alternatively, your agent can poll our lightweight checkpoint status endpoint to check for updates, which is useful for local agents or environments behind strict firewalls.

What file types can Relayna display to reviewers?

Relayna supports and renders all standard file types in the browser, including PDFs, images (PNG, JPG, WEBP), CSVs, JSON data, and plain text. If a file cannot be rendered natively, the reviewer is provided a secure download button.

Pricing & Limits

Is there a free plan for Relayna?

Yes. The Relayna Starter plan is completely free and includes up to 100 human review checkpoints per month, making it ideal for testing and side projects.

What happens if I exceed my monthly checkpoint limit?

On the Builder and Scale plans, we will notify you as you approach your limit. Your workflows will not be hard-blocked immediately. For custom high-volume needs, contact our enterprise team.

Do you offer annual billing discounts?

Yes. Annual billing is available on all paid plans and includes a discount equivalent to two months free per year.

Still have questions?

We're here to help you build better AI workflows. Reach out to our team anytime.

Contact Support