PolyBridgePolyBridge APIBeta
Demo
APIStandards

Standards and Conventions

Use JSON over HTTPS.

Base URL

Public routes use /v1. The public OpenAPI schema is available at /openapi-public.json.

Base URLhttps://api.polybridge.ai
VersionRoutes are under /v1
Schema/openapi-public.json

Requests

Send JSON request bodies with Content-Type. Omit Authorization for anonymous use. Send bearer authentication for API-key usage.

  • Use Content-Type: application/json for JSON request bodies.
  • Omit Authorization for anonymous Search, Forecast, or Hosted MCP.
  • Use Authorization: Bearer <POLYBRIDGE_API_KEY> for API-key requests.
  • Invalid or malformed auth fails and does not fall back to anonymous.
  • Do not send API keys in query strings.

Request IDs

You may send X-Request-ID with a request. PolyBridge also returns X-Request-ID in responses.

Keep that value when debugging or contacting support.

Attribution Headers

Attribution headers are optional. They help identify integration context for debugging and reporting.

  • X-Polybridge-Attribution-Code
  • X-Polybridge-Referrer
  • X-Polybridge-Channel
  • X-Polybridge-Tool
  • X-Polybridge-Client
  • X-Polybridge-Client-Version

Attribution headers are not authentication. Do not send secrets, bearer tokens, emails, API keys, or private identifiers in them.