REST API Reference

curl -X GET https://eu1.wextl.com/api/v1/workflows \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: workflows, nextCursor } = await client.workflows.list({ cursor, limit: 50 });

curl -X POST https://eu1.wextl.com/api/v1/workflows \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "folderId": "fld_01HXEXAMPLE",
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const workflow = await client.workflows.create({ name: 'My workflow' });
// Build its graph via applyOps, then deploy() when ready.

curl -X GET https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const draft = await client.workflows.get(workflowId);
// Or the last "Go Live" snapshot:
const deployed = await client.workflows.get(workflowId, { view: 'deployed' });

curl -X PATCH https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "active": true,
  "queuedEvents": "...",
  "recurrence": {
    "kind": "interval",
    "every": 15,
    "unit": "min",
    "timezone": "Europe/London",
    "skipIfRunning": true
  },
  "folderId": "fld_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Fields omitted from the input are left untouched; pass null to explicitly clear folderId/recurrence.
const updated = await client.workflows.update(workflowId, { name: 'Renamed', active: true });

curl -X DELETE https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Refused (409 workflow_active) while active or deployed — deactivate/undeploy first.
await client.workflows.delete(workflowId);

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/ops \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "ops": [
    {
      "op": "..."
    }
  ],
  "expectedUpdatedAt": 1719792000000
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const draft = await client.workflows.get(workflowId);
const result = await client.workflows.applyOps(
  workflowId,
  [{ op: 'rename_node', nodeId: '1', label: 'Step 1' }],
  { expectedUpdatedAt: draft.updatedAt },
);
// result.errors is best-effort — a non-empty array does not mean the whole batch failed.
// result.updatedAt is the workflow's NEW updatedAt — thread it into the next call's expectedUpdatedAt.

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/deploy \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "expectedUpdatedAt": 1719792000000
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const deployed = await client.workflows.deploy(workflowId); // "Go Live"

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/validate \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Run this before declaring a workflow correct — checks duplicate ids, orphan edges, cycles, trigger placement.
const { valid, issues } = await client.workflows.validate(workflowId);

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/resolve-expression \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "expression": "{{3.rows[0].name}}",
  "fromNodeId": "4"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// resolved is null with error set when it can't be resolved yet (e.g. no runs exist) — not a thrown error.
const { resolved, error } = await client.workflows.resolveExpression(workflowId, { expression: '{{3.rows[0].name}}', fromNodeId: '4' });

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/webhook \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "nodeId": "abc123"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Idempotent — a live webhook already bound to this node returns the same url with alreadyBound: true.
const webhook = await client.workflows.createWebhook(workflowId, nodeId);

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/runs \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "nodeId": "abc123",
  "upstreamOutputs": {
    "12": {
      "message": "Hello world",
      "channel": "#general"
    }
  },
  "seedFromRun": {
    "runId": "run_01HXEXAMPLE",
    "nodeId": 0
  }
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// idempotencyKey is strongly recommended if you may retry — without it a
// timeout-and-retry starts a SECOND run, double-charging credits.
const { runId } = await client.workflows.startRun(workflowId, { idempotencyKey: 'my-retry-safe-key-1' });

curl -X PUT https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/tags \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "tagIds": [
    "..."
  ]
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const result = await client.workflows.setTags(workflowId, [tagId1, tagId2]);

curl -X POST https://eu1.wextl.com/api/v1/workflows/wf_01HXEXAMPLE/test-module \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "nodeId": "abc123"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Executes ONE app node with its current parameters — same output shape a real run would produce.
const output = await client.workflows.testModule(workflowId, nodeId);

curl -X GET https://eu1.wextl.com/api/v1/variables \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: variables } = await client.variables.list(); // secret values always null

curl -X GET https://eu1.wextl.com/api/v1/variables/var_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const variable = await client.variables.get(variableId);

curl -X PUT https://eu1.wextl.com/api/v1/variables/var_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "value": null,
  "isSecret": false,
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Upsert by NAME (the argument is the variable name, not a database id).
const result = await client.variables.set('MY_VARIABLE', { value: 'hello', isSecret: false });

curl -X DELETE https://eu1.wextl.com/api/v1/variables/var_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// {id} here IS the database id (from list()/get()), not the name.
await client.variables.delete(variableId);

curl -X GET https://eu1.wextl.com/api/v1/runs \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// workflowId is REQUIRED — org-wide listing is out of scope in v1.
const { data: runs, nextCursor } = await client.runs.list({ workflowId, limit: 50 });

curl -X GET https://eu1.wextl.com/api/v1/runs/run_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const report = await client.runs.get(runId); // status + per-node status/error/output

curl -X POST https://eu1.wextl.com/api/v1/runs/run_01HXEXAMPLE/cancel \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const result = await client.runs.cancel(runId);

curl -X POST https://eu1.wextl.com/api/v1/runs/run_01HXEXAMPLE/rerun \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const attempt = await client.runs.rerun(runId); // re-queues as a new attempt

curl -X POST https://eu1.wextl.com/api/v1/runs/run_01HXEXAMPLE/retry-node \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "nodeId": 0,
  "attemptNumber": 0
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const result = await client.runs.retryNode(runId, { nodeId: 12 });

curl -X POST https://eu1.wextl.com/api/v1/runs/run_01HXEXAMPLE/nodes/node_1/respond \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "response": {
    "approved": true,
    "comment": "Looks good, ship it."
  },
  "attemptNumber": 0
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const result = await client.runs.respondNode(runId, nodeId, { response: { approved: true } });

curl -X GET https://eu1.wextl.com/api/v1/credentials \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: credentials, nextCursor } = await client.credentials.list({ appId: 'slack' });

curl -X POST https://eu1.wextl.com/api/v1/credentials \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "appId": "slack",
  "connectionId": "abc123",
  "name": "My workflow",
  "data": {
    "apiKey": "sk_live_your_api_key_here"
  },
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// OAuth or missing secrets return { status: 'credential_required', connectUrl } instead —
// relay connectUrl to a human, then poll list() until the credential appears.
const result = await client.credentials.create({ appId: 'slack', connectionId: 'oauth2', name: 'Slack' });

curl -X PATCH https://eu1.wextl.com/api/v1/credentials/cred_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "folderId": "fld_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const credential = await client.credentials.update(credentialId, { name: 'Renamed' });

curl -X DELETE https://eu1.wextl.com/api/v1/credentials/cred_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

await client.credentials.delete(credentialId);

curl -X POST https://eu1.wextl.com/api/v1/credentials/cred_01HXEXAMPLE/verify \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const result = await client.credentials.verify(credentialId); // never returns the secret

curl -X POST https://eu1.wextl.com/api/v1/credentials/dynamic-options \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "appId": "slack",
  "rpcId": "abc123",
  "credentialId": "abc123",
  "params": {
    "tableId": "users"
  }
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { items } = await client.credentials.getDynamicOptions({ appId: 'slack', rpcId: 'listChannels', credentialId });

curl -X GET https://eu1.wextl.com/api/v1/databases \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: databases, truncated } = await client.databases.list();

curl -X POST https://eu1.wextl.com/api/v1/databases \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "columns": [
    {
      "name": "Status",
      "type": "select",
      "required": false,
      "indexed": true
    }
  ],
  "description": "...",
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const table = await client.databases.create({ name: 'Customers', columns: [{ name: 'Name', type: 'text' }] });

curl -X GET https://eu1.wextl.com/api/v1/databases/db_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const schema = await client.databases.getSchema(databaseId);

curl -X PATCH https://eu1.wextl.com/api/v1/databases/db_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "columns": [
    {
      "name": "Status",
      "type": "select",
      "required": false,
      "indexed": true
    }
  ]
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Declarative: pass the FULL desired column list — an existing column left out is dropped.
const schema = await client.databases.updateColumns(databaseId, [{ id: existingColumnId, name: 'Status', type: 'select' }]);

curl -X DELETE https://eu1.wextl.com/api/v1/databases/db_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

await client.databases.delete(databaseId);

curl -X GET https://eu1.wextl.com/api/v1/databases/db_01HXEXAMPLE/rows \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// No public DML row-write endpoint exists in v1 — this is read-only.
const { data: rows, count, nextCursor } = await client.databases.queryRows(databaseId, { limit: 50 });

curl -X GET https://eu1.wextl.com/api/v1/structures \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: structures, truncated } = await client.structures.list();

curl -X POST https://eu1.wextl.com/api/v1/structures \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "description": "...",
  "fields": [
    {
      "name": "email",
      "type": "text",
      "required": true
    }
  ],
  "folderId": "fld_01HXEXAMPLE",
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const structure = await client.structures.create({ name: 'Order', fields: [{ name: 'email', type: 'string', required: true }] });

curl -X GET https://eu1.wextl.com/api/v1/structures/struct_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const structure = await client.structures.get(structureId);

curl -X PATCH https://eu1.wextl.com/api/v1/structures/struct_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "description": "...",
  "fields": [
    {
      "name": "email",
      "type": "text",
      "required": true
    }
  ],
  "folderId": "fld_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const structure = await client.structures.update(structureId, { name: 'Renamed' });

curl -X GET https://eu1.wextl.com/api/v1/functions \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: functions, nextCursor } = await client.functions.list();

curl -X POST https://eu1.wextl.com/api/v1/functions \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "code": "...",
  "description": "...",
  "parameters": [
    {
      "name": "amount",
      "type": "number",
      "description": "Order total in cents.",
      "required": true
    }
  ],
  "folderId": "fld_01HXEXAMPLE",
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const fn = await client.functions.create({ name: 'formatTotal', code: 'return amount / 100;' });

curl -X GET https://eu1.wextl.com/api/v1/functions/fn_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const fn = await client.functions.get(functionId); // includes user-owned code

curl -X PATCH https://eu1.wextl.com/api/v1/functions/fn_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "code": "...",
  "description": "...",
  "parameters": [
    {
      "name": "amount",
      "type": "number",
      "description": "Order total in cents.",
      "required": true
    }
  ],
  "folderId": "fld_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const fn = await client.functions.update(functionId, { code: 'return amount / 1000;' });

curl -X GET https://eu1.wextl.com/api/v1/teams \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: teams } = await client.teams.list(); // discovery for workflows.create's teamId

curl -X PATCH https://eu1.wextl.com/api/v1/teams/id_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const team = await client.teams.rename(teamId, 'Customer success');

curl -X GET https://eu1.wextl.com/api/v1/teams/id_01HXEXAMPLE/members \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: members, nextCursor } = await client.teams.listMembers(teamId, { limit: 100 });

curl -X POST https://eu1.wextl.com/api/v1/teams/id_01HXEXAMPLE/members \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "userIds": [
    "..."
  ]
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// All or nothing: every user must already be a member of the organization. Needs team:write.
const { added, alreadyMembers } = await client.teams.addMembers(teamId, [userId1, userId2]);

curl -X POST https://eu1.wextl.com/api/v1/teams/id_01HXEXAMPLE/members/remove \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "userIds": [
    "..."
  ]
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { removed, notMembers } = await client.teams.removeMembers(teamId, [userId]);

curl -X PATCH https://eu1.wextl.com/api/v1/teams/id_01HXEXAMPLE/members/id_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "role": "..."
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// accountant is set or removed by org owners and admins only.
const member = await client.teams.setMemberRole(teamId, userId, 'developer');

curl -X GET https://eu1.wextl.com/api/v1/folders \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: folders } = await client.folders.list(); // discovery for workflows.create's folderId

curl -X POST https://eu1.wextl.com/api/v1/folders \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "parentId": "abc123"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const folder = await client.folders.create({ name: 'Marketing' });

curl -X PATCH https://eu1.wextl.com/api/v1/folders/fld_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "parentId": "abc123"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const folder = await client.folders.update(folderId, { name: 'Renamed' });

curl -X DELETE https://eu1.wextl.com/api/v1/folders/fld_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Contents are NOT cascade-deleted.
await client.folders.delete(folderId);

curl -X GET https://eu1.wextl.com/api/v1/activity \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

// Your own rows; team admins also their teams'; owners/admins everything.
const { events, nextCursor, visibility } = await client.activity.list({ limit: 50 });

curl -X GET https://eu1.wextl.com/api/v1/activity/export \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const res = await client.activity.export({ format: 'csv' }); // the rows you can see, streamed
const csv = await res.text();

curl -X GET https://eu1.wextl.com/api/v1/activity/id_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { event } = await client.activity.get(events[0].key); // event.saves for a merged autosave

curl -X GET https://eu1.wextl.com/api/v1/invitations \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: invitations, nextCursor } = await client.invitations.list({ status: 'pending' }); // owner/admin only

curl -X POST https://eu1.wextl.com/api/v1/invitations \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "email": "...",
  "role": "...",
  "teamId": "team_01HXEXAMPLE"
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const invitation = await client.invitations.create({
  email: 'ana@example.com',
  role: 'billing', // member | admin | billing | viewer | owner (owners only)
});
// Several at once (up to 100): members and pending invitees are reported, not invited again.
const { invitations, alreadyMembers, alreadyInvited } = await client.invitations.createMany({
  emails: ['li@example.com', 'sam@example.com'],
  role: 'viewer',
});
// inviteUrl on each invitation — relay it if email delivery fails.

curl -X DELETE https://eu1.wextl.com/api/v1/invitations/inv_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

await client.invitations.cancel(invitationId);

curl -X POST https://eu1.wextl.com/api/v1/invitations/inv_01HXEXAMPLE/resend \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const invitation = await client.invitations.resend(invitationId); // fresh 48-hour link

curl -X GET https://eu1.wextl.com/api/v1/tags \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const { data: tags } = await client.tags.list();

curl -X POST https://eu1.wextl.com/api/v1/tags \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "color": "..."
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const tag = await client.tags.create({ name: 'Priority', color: 'amber' });

curl -X PATCH https://eu1.wextl.com/api/v1/tags/tag_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My workflow",
  "color": "..."
}'

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

const tag = await client.tags.update(tagId, { name: 'Urgent', color: 'rose' });

curl -X DELETE https://eu1.wextl.com/api/v1/tags/tag_01HXEXAMPLE \
  -H "Authorization: Bearer wextl_..."

import { WextlClient } from '@wextl/sdk';

const client = new WextlClient({ apiKey: 'wextl_...' });

await client.tags.delete(tagId); // deletes its workflow assignments too