Actions

An action is one call to a service with named inputs, such as stripe.post_customers or sheets.read_rows. Operate As builds the service's real request from them, attaches the client's access, and sends it. Agents see the same actions as MCP tools, so the docs use both words.

There are 89,000+ today, across every service below. For anything they don't cover, use a pass-through request.

Where actions come fromCopy Anchor Link

Generated actions are named after the service's own operation, so they follow its API documentation: a path input like spreadsheet_id fills {spreadsheetId} in the path, other parameters go in the query, and body is sent as JSON, or as a form for services such as Stripe that expect one ({"metadata": {"plan": "pro"}} becomes metadata[plan]=pro).

Find an actionCopy Anchor Link

With thousands to choose from, search instead of reading the whole list:

curl "https://api.operate.as/v1/actions?search=create+customer&service=stripe&limit=5" \
  -H "Authorization: Bearer $OPERATE_AS_API_KEY"

Search results leave out each input's full JSON Schema, which can be long. Get one action whole with GET /v1/actions/{name}, such as GET /v1/actions/stripe.post_customers. GET /v1/actions?service=stripe lists one service's actions with their schemas.

One action, everywhereCopy Anchor Link

Run an actionCopy Anchor Link

curl -X POST https://api.operate.as/v1/actions/sheets.add_row \
  -H "Authorization: Bearer $OPERATE_AS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "6f1c2a7e-...",
    "input": {
      "spreadsheet_id": "1BxiM...",
      "range": "Sheet1!A1",
      "values": ["2026-10-16", "Jane Doe", "Cleaning"]
    }
  }'

The libraries' methods come from each service's typed package: operate-as-sheets for Python, @operate-as/sheets for Node and github.com/arcarolabs/operate-as-go/services/sheets for Go. See Service packages. Get the client's ID from the dashboard or GET /v1/me/clients. The answer is the service's own status and response:

{
  "status": 200,
  "data": { "spreadsheetId": "1BxiM...", "updates": { "updatedRange": "Sheet1!A12:C12", "updatedRows": 1 } },
  "encoding": "json"
}

Check status before trusting data: the service can still refuse, such as for a spreadsheet that doesn't exist. See The result.

InputsCopy Anchor Link

GET /v1/actions/{name} returns an action's inputs, each with its jsonSchema when it's more than a plain type, so a program or agent can read them instead of hard-coding them.

Limiting keys to actionsCopy Anchor Link

A key can be limited to a list of actions, like sheets.read_rows. In the dashboard's create form, choose Restricted and select them under Tools. See API keys.

Services with actionsCopy Anchor Link

Every other service works through pass-through requests.

Hand-written actionsCopy Anchor Link

Dropbox has file actions too: dropbox.list_folder, dropbox.upload_file and dropbox.download_file. A download answers with "encoding": "base64", so decode data to get the file.