First-party app
Duda

Duda

Manage Duda sites, pages, form submissions, collections and accounts through the Partner API.

stable Content ManagementForms & SurveysMarketing

About

Duda ships in the w6w first-party pack. It declares 14 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.duda
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Content Management · Forms & Surveys · Marketing

Overview

Duda is a website builder that agencies and SaaS platforms white-label: each of their customers gets a site, an editor and a set of hosted pages. This app is the Partner API front end for the sites those customers live on — listing and fetching them, creating one from a template, and pushing it live or taking it back down again.

It reads the page tree of a site and the contact-form submissions a site has collected, and it works with Collections — Duda’s structured-data tables — end to end: listing the collections on a site, reading one’s fields and rows, and creating, overwriting or deleting rows in bulk.

Accounts round it out, since a partner provisions the people who own those sites: an account can be fetched by name or created outright. Health checks track Duda’s own status page and declare, as a positive fact, that Duda publishes no machine-readable quota. Both regions Duda runs — US and EU — are selectable per Connection.

Build with Duda

Three routes to the same 14 actions. The Workflow tab is generated from Duda's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Create Account

create-account

Create an account for a customer or staff member. Answers 204 with no content — Duda does not send the new account an email. Duda's rate limit for this endpoint is 60 calls/minute.

Create Collection Rows

create-collection-rows

Append rows to a collection. The body is a raw JSON array of `{ data: { … } }` objects.

Create Site

create-site

Create a site from a template. Duda's own rate limit for this endpoint is 60 calls/minute, on top of the global 10 calls/second.

Delete Collection Rows

delete-collection-rows

Delete rows from a collection by id. The body is a raw JSON array of row ids.

Get Account

get-account

Fetch one account by its name identifier.

Get Collection

get-collection

Fetch one collection's fields and rows.

Get Form Submissions

get-form-submissions

Read the contact-form submissions a site has collected. Duda's own rate limit for this endpoint is 300 calls/minute.

Get Site

get-site

Fetch one site by its `site_name` alias.

List Collections

list-collections

List the collections (structured-data tables) on a site, including each one's fields and rows.

List Pages

list-pages

List a site's pages (Pages v2): path, title, type, draft status, and the collection a dynamic page is bound to.

List Sites

list-sites

List the sites under this account, newest first. Sites with a status of 'In Planning' are never returned by Duda.

Publish Site

publish-site

Publish a site to its live domain. Answers 204 with no content. Duda's rate limit for this endpoint is 20 calls/minute.

Unpublish Site

unpublish-site

Take a site off its live domain without deleting it. Answers 204 with no content. Duda's rate limit for this endpoint is 20 calls/minute.

Update Collection Rows

update-collection-rows

Overwrite whole rows in a collection. The body is a raw JSON array of `{ id, data }` objects. Answers 204 with no content.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Duda's real ids.

{
  "manifestVersion": "2",
  "name": "duda-example",
  "steps": [
    {
      "id": "create-account",
      "uses": {
        "app": "io.w6w.duda",
        "action": "create-account",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "accountName": "<accountName>",
        "firstName": "<firstName>",
        "lastName": "<lastName>"
      }
    }
  ]
}

Here are some of the things you can do

  • Create Account

    perform
    create-account
  • Create Collection Rows

    perform
    create-collection-rows
  • Create Site

    perform
    create-site
  • Get Account

    read
    get-account
  • Get Collection

    read
    get-collection

+9 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Duda, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Duda. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "create-account",
  payload: {
    accountName: "<value>",
    firstName: "<value>",
    lastName: "<value>",
    // email: "<value>",
    // accountType: "<value>",
    // companyName: "<value>",
    // lang: "<value>",
    // standing: "<value>",
    // status: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action create-account --payload '{"accountName":"<value>","firstName":"<value>","lastName":"<value>"}'

Give an AI agent Duda — without giving it Duda's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.duda#create-account",
    "input": {
      "accountName": "<accountName>",
      "firstName": "<firstName>",
      "lastName": "<lastName>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Duda connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Duda's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Duda itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Duda declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Duda API status

The `API` component of Duda's own status page. The page's other components — Live Sites, Editor, Sandbox, eCommerce — are Duda's UI and hosting surfaces and do not affect this app.

quota

API request headroom