Serverless Workers

Serverless Workers are serverless functions that run JavaScript code in the cloud.

Workers run server-side, which makes them a good fit for centralized application data and backend logic. See Integration with Puter.js for how worker code accesses Puter resources.

Router

Workers use a router-based system to handle HTTP requests and can integrate with Puter's cloud services like file storage, key-value databases, and AI APIs. Workers are perfect for building backend services, REST APIs, webhooks, shared data stores, and data processing pipelines.

Examples

// Simple GET endpoint
router.get("/api/hello", async ({ request }) => {
  return { message: "Hello, World!" };
});

router.post("/api/user", async ({ request }) => {
  // Get JSON body
  const body = await request.json();
  return { processed: true };
});

// Dynamic route with parameters
router.get("/api/posts/:category/:id", async ({ request, params }) => {
  const { category, id } = params;
  return { category, id };
});

router.get("/api/simple", async ({ request }) => {
  return { status: "ok" }; // Automatically converted to JSON
});

router.post("/api/kv/set", async ({ request }) => {
  const { key, value } = await request.json();

  if (!key || value === undefined) {
    return new Response(JSON.stringify({ error: "Key and value required" }), {
      status: 400,
      headers: { "Content-Type": "application/json" },
    });
  }

  await me.puter.kv.set("myscope_" + key, value); // add a mandatory prefix so this wont blindly read the KV of the user's other data
  return { saved: true, key };
});

router.get("/api/kv/get/:key", async ({ request, params }) => {
  const key = params.key;
  const value = await me.puter.kv.get("myscope_" + key); // use the same prefix

  if (!value) {
    return new Response(JSON.stringify({ error: "Key not found" }), {
      status: 404,
      headers: { "Content-Type": "application/json" },
    });
  }

  return { key, value: value };
});

Object

• router - The router object for handling HTTP requests

Tutorials

• How to Run Serverless Functions on Puter

Workers API

In addition, the Puter.js Workers API lets you create, manage, and execute these workers programmatically. The API provides comprehensive management features including create, delete, list, get, and execute worker.

Functions

These workers management features are supported out of the box when using Puter.js:

• puter.workers.create() - Create a new worker
• puter.workers.delete() - Delete a worker
• puter.workers.list() - List all workers
• puter.workers.get() - Get information about a specific worker
• puter.workers.exec() - Execute a worker

Examples

You can see various Puter.js workers management features in action from the following examples:

• Create a worker
• List workers
• Get a worker
• Workers Management
• Authenticated Worker Requests

Deployment

Once your worker is ready, you can put it online on a free *.puter.work subdomain.

Publish from puter.com

The quickest way to publish a worker is to create it on puter.com and publish it.

1. Create a .js file containing your worker code.

   

2. Right-click the file and choose Publish as Worker.

   

3. Pick a name and click Publish. Your worker is live at https://your-worker.puter.work.