Responses and errors

Axiora does not return bare arrays as the primary response shape. The API consistently wraps results with data, and collection endpoints add meta and links.

Shared response envelope

Single-resource responses typically contain:

• data for the business object itself
• links for self or related navigation

Collection pattern

Collection responses usually add:

• meta for paging and size information
• links for navigation or self references

Error responses

Unauthorized, not found, and invalid argument responses are modeled explicitly in the OpenAPI contract. Clients should branch on these instead of treating all non-200 responses generically.

const response = await fetch(url, options);

if (!response.ok) {
const payload = await response.json();
throw new Error(payload.error?.message ?? "Unknown API error");
}

const payload = await response.json();