w6w docs

Quickstart

w6w puts every API your product runs on — the ones you own and the ones you buy — behind one access point and one credential. This page gets you from nothing to a first real call.

1. Get access

w6w isn’t self-serve yet. Request access from the homepage and you’ll get back a base URL and an API token for your account.

2. Install a client

Pick the language your product is in. All three share one version and one set of operations.

npm install @w6w/sdk       # TypeScript / JavaScript
npm install -g @w6w/cli    # w6w <command>, on top of the same SDK
pip install w6w            # Python

3. Configure it

Two values, from step 1:

export W6W_BASE_URL=https://api.example.com   # your account's origin, no trailing path
export W6W_TOKEN=…                             # sent as a Bearer token on every call

4. Make your first call

import { W6WClient, isActionRun } from "@w6w/sdk";

const client = new W6WClient(); // reads W6W_BASE_URL and W6W_TOKEN

const me = await client.me();               // who am I, which versions am I talking to?
const connections = await client.connections.list(); // what can I run?

const result = await client.run({
  urn: connections[0].id, // a conn_… id resolves to an app action
  action: "send_message",
  payload: { channel: "#general", text: "Hello from w6w" },
});
if (isActionRun(result)) console.log(result.value);

Same call from the CLI:

w6w connections list
w6w run conn_01H… --action send_message --payload '{"channel":"#general","text":"Hello from w6w"}'

run also takes a fn_… (Function), ep_… (Endpoint), or wf_… (Workflow) id — same call shape, no --action needed since each of those has exactly one operation.

Where to next

  • Browse the apps — the ready-made integrations, and what each one’s actions, connections, and health checks look like.
  • Build a w6w app — the full agent-ready guide for authoring a new integration as code, if the app you need isn’t built yet.
  • The App contract and Composition sections in the rail — the RFCs behind Action, Auth, Function, Endpoint, and Workflow, if you want the spec, not just the shape.