Developer sandbox

Test your integration in seconds

The sandbox returns realistic mocked responses without touching the database. Use it to build and verify your webhook handling, error logic, and integration flow before going live.

Quick start

Use the sandbox API key sandbox_test_key or add header x-sandbox: 1

curl -X POST https://verifiedworkflows.com/v1/sandbox/tasks \
  -H "Authorization: Bearer sandbox_test_key" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The capital of France is Berlin.",
    "content_type": "text",
    "review_type": "fact_check",
    "review_depth": "standard"
  }'

Available endpoints

POST
/v1/sandbox/tasks

Create a task. Returns pending status with estimated cost and turnaround.

GET
/v1/sandbox/tasks/{task_id}

Get task result. Returns completed status with mock reviewer output.

GET
/v1/sandbox/tasks

List demo tasks. Returns 3 sample tasks in various statuses.

GET
/v1/sandbox/analytics/summary

Mocked analytics data. Useful for testing dashboard integrations.

POST
/v1/sandbox/webhook/echo

Echo back your webhook payload. Useful for testing your callback handler.

Python SDK

from verifiedworkflows import VerifiedWorkflows

client = VerifiedWorkflows(api_key="sandbox_test_key", base_url="https://verifiedworkflows.com/v1")

task = client.tasks.create(
    content="The capital of France is Berlin.",
    content_type="text",
    review_type="fact_check"
)
print(task)
# {'task_id': 'sb_a1b2c3d4e5f6', 'status': 'pending', 'estimated_tokens': 1, ...}

result = client.tasks.get(task["task_id"])
print(result)
# {'task_id': 'sb_a1b2c3d4e5f6', 'status': 'completed', 'result': {...}}

Node.js SDK

import { VerifiedWorkflowsClient } from "@verifiedworkflows/sdk";

const client = new VerifiedWorkflowsClient({ api_key: "sandbox_test_key" });

const task = await client.tasks.create({
  content: "The capital of France is Berlin.",
  content_type: "text",
  review_type: "fact_check"
});
console.log(task);
// { task_id: 'sb_a1b2c3d4e5f6', status: 'pending', ... }

const result = await client.tasks.get(task.task_id);
console.log(result);
// { task_id: 'sb_a1b2c3d4e5f6', status: 'completed', result: {...} }

Ready to go live?

Switch from sandbox_test_key to your real API key and point to the production endpoints.

Get your API key