Documentation

curl -X POST https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer ak_ws_YOUR_API_KEY" \
  -H "X-Credential-Name: Resend" \
  -H "X-Target-Url: https://api.resend.com/emails" \
  -H "Content-Type: application/json" \
  -d '{"from": "hi@example.com", "to": "user@example.com", "subject": "Hello", "text": "Sent via AgentKeys"}'

curl -X POST https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer pxr_YOUR_PROXY_TOKEN" \
  -H "X-Target-Url: https://api.resend.com/emails" \
  -H "Content-Type: application/json" \
  -d '{"from": "hi@example.com", "to": "user@example.com", "subject": "Hello", "text": "Sent via AgentKeys"}'

npm install -g @agentkeys-io/cli

npx @agentkeys-io/cli <command>

# Initialize config and authenticate
agentkeys init

# Log in with your workspace API key
agentkeys login

# Check current status
agentkeys status

{
  "apiKey": "ak_ws_...",
  "apiUrl": "https://app.agentkeys.io",
  "workspaceId": "ws_..."
}

# List all credentials
agentkeys credentials list

# Add a new API key credential
agentkeys credentials add \
  --name "Resend Production" \
  --type API_KEY \
  --value "sk-..."

# Add a basic auth credential interactively
agentkeys credentials add --name "Jira" --type BASIC_AUTH

# Remove a credential
agentkeys credentials remove <credential-id>

# List all agents
agentkeys agents list

# Create a new agent
agentkeys agents create --name "marketing-bot"

# Create an agent and assign a credential in one step
agentkeys agents create \
  --name "data-pipeline" \
  --credential <credential-id>

# Remove an agent
agentkeys agents remove <agent-id>

# Proxy a GET request
agentkeys proxy <proxy-token> https://api.github.com/user/repos

# Proxy a POST request with JSON body
agentkeys proxy <proxy-token> https://api.resend.com/emails \
  --method POST \
  --data '{"from":"hi@example.com","to":"user@example.com","subject":"Hello","text":"Test"}'

npx @agentkeys-io/mcp

{
  "mcpServers": {
    "agentkeys": {
      "command": "npx",
      "args": ["@agentkeys-io/mcp"],
      "env": {
        "AGENTKEYS_API_KEY": "ak_ws_..."
      }
    }
  }
}

{
  "mcpServers": {
    "agentkeys": {
      "command": "npx",
      "args": ["@agentkeys-io/mcp"],
      "env": {
        "AGENTKEYS_API_KEY": "ak_ws_..."
      }
    }
  }
}

clawhub install agentkeys

AGENTKEYS_API_KEY=ak_ws_your_key...
AGENTKEYS_PROXY_URL=https://proxy.agentkeys.io

AGENTKEYS_PROXY_TOKEN_RESEND=pxr_resend_abc123...
AGENTKEYS_PROXY_TOKEN_STRIPE=pxr_stripe_def456...
AGENTKEYS_PROXY_TOKEN_GITHUB=pxr_github_ghi789...
AGENTKEYS_PROXY_URL=https://proxy.agentkeys.io

You: Send an email via Resend to user@example.com
Agent: (uses AgentKeys proxy → Resend API) ✅ Email sent!

You: Create a Jira ticket for this bug
Agent: (uses AgentKeys proxy → Jira API) ✅ Ticket PROJ-42 created!

You: Check my Stripe balance
Agent: (uses AgentKeys proxy → Stripe API) Current balance: $1,234.56

https://app.agentkeys.io/api/v1

Authorization: Bearer ak_ws_YOUR_WORKSPACE_KEY

{
  "error": "Credential not found",
  "code": "NOT_FOUND",
  "status": 404
}

{
  "id": "evt_01J...",
  "event": "credential.expiring_soon",
  "workspaceId": "ws_...",
  "timestamp": "2025-06-01T09:00:00Z",
  "data": {
    "credentialId": "cred_abc123",
    "credentialName": "Resend Production",
    "expiresAt": "2025-06-08T09:00:00Z"
  }
}

import crypto from "crypto";

const WEBHOOK_SECRET = process.env.AGENTKEYS_WEBHOOK_SECRET;

export function verifyWebhook(
  rawBody: string,
  signature: string
): boolean {
  const expected = crypto
    .createHmac("sha256", WEBHOOK_SECRET)
    .update(rawBody, "utf8")
    .digest("hex");

  // Use timingSafeEqual to prevent timing attacks
  return crypto.timingSafeEqual(
    Buffer.from(signature, "hex"),
    Buffer.from(expected, "hex")
  );
}

// Express example
app.post("/webhooks/agentkeys", express.raw({ type: "*/*" }), (req, res) => {
  const sig = req.headers["x-agentkeys-signature"] as string;
  if (!verifyWebhook(req.body.toString(), sig)) {
    return res.status(401).json({ error: "Invalid signature" });
  }

  const event = JSON.parse(req.body.toString());
  console.log("Received event:", event.event);

  res.sendStatus(200);
});

import hmac
import hashlib

def verify_webhook(raw_body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode("utf-8"),
        raw_body,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

# Flask example
@app.route("/webhooks/agentkeys", methods=["POST"])
def handle_webhook():
    sig = request.headers.get("X-AgentKeys-Signature", "")
    if not verify_webhook(request.data, sig, WEBHOOK_SECRET):
        return jsonify({"error": "Invalid signature"}), 401

    event = request.get_json(force=True)
    print(f"Received event: {event['event']}")
    return "", 200

POST https://proxy.agentkeys.io/v1/proxy

pxr_<random_256_bit_token>

curl -X POST https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer pxr_resend_abc123" \
  -H "X-Target-Url: https://api.resend.com/emails" \
  -H "Content-Type: application/json" \
  -d '{"from": "hi@example.com", "to": "user@example.com", "subject": "Hello", "text": "Sent via AgentKeys"}'

curl -X POST https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer pxr_anthropic_def456" \
  -H "X-Target-Url: https://api.anthropic.com/v1/messages" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model": "claude-opus-4-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello!"}]}'

curl https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer pxr_github_ghi789" \
  -H "X-Target-Url: https://api.github.com/user/repos"

curl -X POST https://proxy.agentkeys.io/v1/proxy \
  -H "Authorization: Bearer pxr_resend_jkl012" \
  -H "X-Target-Url: https://api.resend.com/emails" \
  -H "Content-Type: application/json" \
  -d '{"from": "hi@yourdomain.com", "to": "user@example.com", "subject": "Hello", "text": "Hello!"}'

npm install @agentkeys-io/sdk

import { AgentKeys } from "@agentkeys-io/sdk";

const ak = new AgentKeys({
  token: "ak_ws_your_key...",
  proxyUrl: "https://proxy.agentkeys.io",
});

// Proxy by credential name
const res = await ak.proxy("resend", {
  url: "https://api.resend.com/emails",
  method: "POST",
  body: { from: "hi@example.com", to: "user@example.com", subject: "Hello", text: "Sent via AgentKeys" },
});

console.log(await res.json());

const stripe = ak.for("stripe");
const resend = ak.for("resend");

const balance = await stripe.get("https://api.stripe.com/v1/balance");
await resend.post("https://api.resend.com/emails", { from: "hi@example.com", to: "user@example.com", subject: "Test", text: "Hello" });

const ak = new AgentKeys({ token: "pxr_resend_abc123..." });
const res = await ak.proxy("ignored", { url: "https://api.resend.com/emails", method: "POST", body: { ... } });

pip install agentkeys

from agentkeys import AgentKeys

ak = AgentKeys(
    token="ak_ws_your_key...",
    proxy_url="https://proxy.agentkeys.io",
)

# Proxy by credential name
res = ak.proxy(
    credential="resend",
    url="https://api.resend.com/emails",
    method="POST",
    body={"from": "hi@example.com", "to": "user@example.com", "subject": "Hello", "text": "Sent via AgentKeys"},
)

print(res.json())

stripe = ak.for_credential("stripe")
resend = ak.for_credential("resend")

balance = stripe.get("https://api.stripe.com/v1/balance")
resend.post("https://api.resend.com/emails", body={"from": "hi@example.com", "to": "user@example.com", "subject": "Test", "text": "Hello"})

ak = AgentKeys(token="pxr_resend_abc123...")
res = ak.proxy(credential="ignored", url="https://api.resend.com/emails", method="POST", body={...})