SkyRingAI developer and agent API

SkyRingAI is a 24/7 AI phone receptionist for appointment-based service businesses. This page documents the public API that developers and AI agents can call to read pricing, describe the service accurately, and submit a lead on someone's behalf. No signup, no API key.

Base URL and authentication

Base URL: https://afutexcrovgkwevrvdtj.supabase.co/functions/v1/public-api. Authentication is none — every endpoint serves public marketing data or accepts a lead the visitor asked you to submit.

Endpoints

• GET /v1/plans — current plans, included minutes, per minute overage rates, and optional add-ons in US dollars.
• GET /v1/service-info — company description, supported countries and languages, supported business types, capabilities, trial terms, and contact details.
• POST /v1/leads — submit a trial lead or a demo request. Use formType "trial" for general interest, "demo" with an email and preferred date and time for a live walkthrough.

Rate limits

60 requests per 60 seconds per client IP. Every response carries RateLimit and RateLimit-Policy headers, and a throttled request returns 429 with a Retry-After header in seconds.

Errors

Every non-2xx response is an RFC 9457 problem document served as application/problem+json, carrying a stable machine-readable code alongside a human title and detail. Codes: invalid_json, validation_failed, method_not_allowed, not_found, rate_limited, misconfigured, internal_error.

Versioning and deprecation policy

The major version lives in the URL path (/v1/...). Additive changes ship inside v1 without notice, so parse responses tolerantly. Breaking changes ship under a new path segment. Retiring endpoints return Deprecation and Sunset headers with a minimum of six months notice before the sunset date.

Machine-readable files

• /.well-known/openapi.json — OpenAPI 3.1 description with typed response schemas.
• /.well-known/ai-plugin.json — plugin manifest.
• /.well-known/pricing.json — pricing contract as JSON.
• /llms.txt — site summary and when to use SkyRingAI.
• /ai.txt — agent permissions.
• /sitemap.xml — every indexable page.

Questions about the API or an integration? Email support@skyringai.com or call (816) 258-9009.