actionsL4 automation

Third-party APIs, without the glue code.

A pack describes a service's actions and triggers in one b3pack.json: request templates, response mapping and the hosts it may reach. Your credentials stay in the vault and are added at the egress proxy, so pack code never sees them.

Get API key Read the docs

API: /v1/actions
CLI: b3os action search · b3os action run
MCP tools: actions_*

[01/03] What it does

Search, describe, call

Find an action, read its input schema, call it. Every action is also a valid MCP tool.

GET /v1/actions/search · POST /v1/actions/call

Your credentials

API keys, basic auth, bearer and OAuth tokens that belong to you, bound to the exact hosts the pack declares.

/v1/vault/connections

Triggers for routines

Webhook, polling and schedule triggers start routines when something happens in another service.

GET /v1/actions/triggers

Verified packs

Nodes check each pack's content hash and publisher signature against the registry before loading it.

GET /v1/actions/packs

Where your credential goes

Call
An agent or routine calls io.b3os/github/create-issue@1 with a connection id.
Template
The pack's request template is filled and validated against its schema.
Egress proxy
The token is added here, only for the host the pack declares.
api.github.com
The response is mapped back through the pack's CEL expressions.

1# Find an action
2curl -sS "https://beta-api.b3os.org/v1/actions/search?q=create%20github%20issue" \
3  -H "Authorization: Bearer $B3OS_API_KEY"
4
5# Call it with a stored connection
6curl -sS https://beta-api.b3os.org/v1/actions/call \
7  -H "Authorization: Bearer $B3OS_API_KEY" \
8  -H "Content-Type: application/json" \
9  -d '{"ref":"io.b3os/github/create-issue@1","input":{"owner":"acme","repo":"web","title":"Checkout button misaligned on mobile"},"connections":{"api":"conn_01m5t6cbgdjs1ketgcqwa2sne8"}}'

# Find an action
curl -sS "https://beta-api.b3os.org/v1/actions/search?q=create%20github%20issue" \
  -H "Authorization: Bearer $B3OS_API_KEY"

# Call it with a stored connection
curl -sS https://beta-api.b3os.org/v1/actions/call \
  -H "Authorization: Bearer $B3OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ref":"io.b3os/github/create-issue@1","input":{"owner":"acme","repo":"web","title":"Checkout button misaligned on mobile"},"connections":{"api":"conn_01m5t6cbgdjs1ketgcqwa2sne8"}}'

1const res = await fetch("https://beta-api.b3os.org/v1/actions/call", {
2  method: "POST",
3  headers: {
4    Authorization: `Bearer ${process.env.B3OS_API_KEY}`,
5    "Content-Type": "application/json",
6  },
7  body: JSON.stringify({
8    ref: "io.b3os/github/create-issue@1",
9    input: {
10      owner: "acme",
11      repo: "web",
12      title: "Checkout button misaligned on mobile",
13    },
14    connections: { api: "conn_01m5t6cbgdjs1ketgcqwa2sne8" },
15  }),
16});
17if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
18const data = await res.json();
19console.log(res.headers.get("server-timing"));

const res = await fetch("https://beta-api.b3os.org/v1/actions/call", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.B3OS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    ref: "io.b3os/github/create-issue@1",
    input: {
      owner: "acme",
      repo: "web",
      title: "Checkout button misaligned on mobile",
    },
    connections: { api: "conn_01m5t6cbgdjs1ketgcqwa2sne8" },
  }),
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();
console.log(res.headers.get("server-timing"));

1import os
2
3import httpx
4
5res = httpx.post(
6    "https://beta-api.b3os.org/v1/actions/call",
7    headers={"Authorization": f"Bearer {os.environ['B3OS_API_KEY']}"},
8    json={
9        "ref": "io.b3os/github/create-issue@1",
10        "input": {
11            "owner": "acme",
12            "repo": "web",
13            "title": "Checkout button misaligned on mobile",
14        },
15        "connections": {"api": "conn_01m5t6cbgdjs1ketgcqwa2sne8"},
16    },
17    timeout=65,
18)
19res.raise_for_status()
20data = res.json()
21print(res.headers.get("server-timing"))

import os

import httpx

res = httpx.post(
    "https://beta-api.b3os.org/v1/actions/call",
    headers={"Authorization": f"Bearer {os.environ['B3OS_API_KEY']}"},
    json={
        "ref": "io.b3os/github/create-issue@1",
        "input": {
            "owner": "acme",
            "repo": "web",
            "title": "Checkout button misaligned on mobile",
        },
        "connections": {"api": "conn_01m5t6cbgdjs1ketgcqwa2sne8"},
    },
    timeout=65,
)
res.raise_for_status()
data = res.json()
print(res.headers.get("server-timing"))

1{
2  "name": "actions_call",
3  "arguments": {
4    "ref": "io.b3os/github/create-issue@1",
5    "input": {
6      "owner": "acme",
7      "repo": "web",
8      "title": "Checkout button misaligned on mobile"
9    },
10    "connections": {
11      "api": "conn_01m5t6cbgdjs1ketgcqwa2sne8"
12    }
13  }
14}

{
  "name": "actions_call",
  "arguments": {
    "ref": "io.b3os/github/create-issue@1",
    "input": {
      "owner": "acme",
      "repo": "web",
      "title": "Checkout button misaligned on mobile"
    },
    "connections": {
      "api": "conn_01m5t6cbgdjs1ketgcqwa2sne8"
    }
  }
}

Every pack in the catalog runs on your own credentials or a keyless public API. B3 does not pay for upstream keys, and packs neither route through residential proxies nor sign wallet transactions.

[02/03] Measured

What we measure for actions

Values appear here only from published benchmark runs, each with its raw data. A row that says measuring has no published run yet.

Declarative action overhead

Time added by the action runtime, upstream excluded, for responses up to 16 KB.

Measuringp50, server side

Input validation

JSON Schema validation of an action's input.

Measuringp50, server side

JavaScript action overhead

Warm overhead of a first-party JavaScript action.

Measuringp50, server side

T0 call total minus upstream, per MiB of upstream response, for responses over 16 KB

Measuringp50, server side

How we measure, and what others publish

[03/03] Beta limits

Free during the beta, with caps

Caps per organization

Action calls per minute: 300

Metered units

Action calls: actions.call

Pricing details