API Reference
Authentication
Authenticated endpoints require a Bearer token in the Authorization header.
Authorization: Bearer ysk_prov_your_api_key_hereysk_prov_*
Provider API key. Scoped to own listing and members.
ysk_svc_*
Service token. Admin-level access for internal tools.
Base URL
| Studio registry (pending) | https://studio-registry.example.invalid |
| Local | http://localhost:5175 |
Error Format
{
"error": "Human-readable error message",
"code": "OPTIONAL_ERROR_CODE"
}| Status | Meaning |
|---|---|
| 400 | Bad request (validation error) |
| 401 | Missing or invalid authentication |
| 403 | Authenticated but insufficient permissions |
| 404 | Resource not found |
| 409 | Conflict (duplicate resource) |
| 429 | Rate limited (try again later) |
| 500 | Internal server error |
Rate Limits
- Public endpoints: 60 requests/minute per IP
- Provider interest: 3 submissions/email/24h
- Authenticated endpoints: 300 requests/minute per key