V
Veyra Developer Console
Veyra Agent API v1
Arc Testnet · Chain 5042002

Veyra Agent API

Machine-to-machine access for agents that discover workflows, create quotes, execute paid runs, and retrieve verified reports.

Download OpenAPI Spec (.json)Create API Credential
Veyra Agent API Credentials
Complete the three onboarding steps, then create a namespace-bound credential. Secrets are shown only once.
  1. 1

    Verify owner

    Connect and verify the owner wallet in Agent Credentials.

  2. 2

    Activate namespace

    Register an agent and enable only the workflows it may run.

  3. 3

    Create credential

    Copy the one-time secret into your agent secret manager.

Loading credential manager…

Machine-to-Machine
Built for autonomous agent runtimes. Requires no browser or human interaction. Full idempotency protection on every state mutation.
Sponsored & Paid x402
Quotes seamlessly route through sponsored daily developer quota or explicit x402 USDC payment transactions on Arc Testnet.
Arc Verifiable Proofs
Final reports include immutable Arc block explorer links and proof hashes verifying allowlisted x402 service purchases.
Credential Scopes & Endpoints
Scoped bearer credential
Machine credentials use a closed scope set bound to one active agent namespace. A mismatched credential returns 403 scope_denied.
ScopeEndpointDescription
workflows:read
GET /api/agent/v1/workflowsDiscover available workflow templates, list prices in USDC, and input schemas.
quotes:create
POST /api/agent/v1/quotesCreate an immutable execution quote bound to workflow input with Idempotency-Key protection.
runs:create
POST /api/agent/v1/runsLaunch sponsored or paid x402 workflow execution for a valid quote.
results:read
GET /api/agent/v1/runs/[runId] · GET /api/agent/v1/reports/[reportId]Poll run status and retrieve structured reports with Arc Testnet verification proofs.
Interactive Code Examples & SDK Quickstart
TypeScript · Python · cURL
Copy runnable code snippets or test endpoints directly in your terminal.
import { AgentCommerceApiError, AgentCommerceClient } from "@arc-agent-commerce/sdk";

const client = new AgentCommerceClient({
  baseUrl: "https://agent-commerce-six.vercel.app",
  credential: process.env.ARC_AGENT_COMMERCE_API_KEY!,
});

try {
  const { report } = await client.executeWorkflow({
    workflow: "github_due_diligence",
    repository: "circlefin/developer-controlled-wallets-web-sdk",
  }, {
    // Persist these keys in a real agent so a process restart replays safely.
    quoteIdempotencyKey: "github-quote-001",
    runIdempotencyKey: "github-run-001",
    wait: {
      onStatus: ({ status, progress }) =>
        console.log(status, Math.round(progress * 100) + "%"),
    },
  });

  console.log(report.verdict);
  console.log(report.verification);
} catch (error) {
  if (error instanceof AgentCommerceApiError) {
    console.error(error.code, error.retryable, error.requestId);
  }
  throw error;
}

OpenAPI 3.0.3 Specification

Import the complete Veyra Agent API specification into Postman, Insomnia, or Swagger UI.

View JSONDownload Spec