API behavior

Errors

Understand the error shape returned by the Developer API.

Errors use JSON responses and an HTTP status code. Validation errors are returned at the route boundary before a mutation is performed.

Authentication: management API endpoints require a Clerk bearer token.https://api.vyso.io/v1/...

Endpoints

GETHTTP status and response shape

Common responses

  • 401 means authentication is missing or invalid.
  • 400 means the request parameters or body failed validation.
  • 404 means the requested workspace resource was not found.
  • 409 is used for conflicts such as duplicate collection or preset names.
  • 429 means the rate limit was exceeded.
  • 5xx responses indicate a server-side failure.
{"error":"Asset not found."}