SHOP API V1

Build on your shop's calls and jobs

One API key per integration. Call app.tryedison.com/api/v1 from your stack, subscribe to webhooks, or point Claude, Cursor, or ChatGPT at the same shop via MCP.

Pick a starting point

Quickstart

Key + first GET /me

Authentication

Bearer keys and scopes

Rate limits

120 requests per minute

Idempotency

Safe retries on writes

Errors

Codes and envelopes

Credits & pricing

Trial and plan credits

Webhooks

Events, signatures, retries

MCP

Claude, Cursor, ChatGPT

What you can reach

Every documented REST route, grouped. Each has curl and JavaScript on its reference page.

Full API reference →

Enable once. Use it either way.

In the Edison app, open Settings → API / Agent. Mint a named REST key (ed_live_ or ed_test_) or the agent token for MCP. Rotate a key to disconnect an integration.

Call it yourself

HTTPS + Bearer header. JSON envelope with data and request_id.

BASH

curl https://app.tryedison.com/api/v1/me \
  -H "Authorization: Bearer ed_test_…"

Hand it to an agent

Same shop scope at the MCP URL. Start with the whoami tool.

JSON

{
  "mcpServers": {
    "edison": {
      "url": "https://app.tryedison.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ed_test_…"
      }
    }
  }
}