# Aspas Labs API

> Developer documentation for the Aspas Labs API and Goldenfish structured decisions.

- [Aspas Labs API](https://docs.quackpay.com.br/index.md): Use Goldenfish to turn context into structured decisions through a small, stable HTTP API.
- [Quickstart](https://docs.quackpay.com.br/quickstart.md): Make your first Goldenfish decision with the production HTTP API.
- [Authentication](https://docs.quackpay.com.br/authentication.md): Send Goldenfish API keys safely when an endpoint requires authentication.
- [Decisions](https://docs.quackpay.com.br/concepts/decisions.md): Understand the Goldenfish decision request and response model.
- [Models](https://docs.quackpay.com.br/concepts/models.md): Discover Goldenfish models, statuses, revisions, and public limits.
- [Catalogs](https://docs.quackpay.com.br/concepts/catalogs.md): Store and reuse named choice sets for repeatable decision workflows.
- [Route support requests](https://docs.quackpay.com.br/guides/support-routing.md): Build a support classification workflow with Goldenfish choices and a safe fallback.
- [Build a catalog workflow](https://docs.quackpay.com.br/guides/catalog-workflow.md): Create a reusable choice catalog and use it from decision requests.
- [Production checklist](https://docs.quackpay.com.br/guides/production-checklist.md): Prepare a Goldenfish integration for reliability, security, and operability.
- [API overview](https://docs.quackpay.com.br/api-reference/overview.md): Base URL, endpoint map, request conventions, and response conventions for the Aspas Labs API.
- [Turn context into a typed decision.](https://docs.quackpay.com.br/api-reference/decisions/turn-context-into-a-typed-decision.md): Send input, an instruction and either an inline choice list or a previously created catalogue. The response contains the selected choice, confidence and probabilities keyed by the original choice strings.
- [List available models.](https://docs.quackpay.com.br/api-reference/models/list-available-models.md): Returns the models visible to the caller, including each model's status and public limits. Use the returned `id` value in a decision request. A bearer key is optional in the current contract.
- [Get one model descriptor.](https://docs.quackpay.com.br/api-reference/models/get-one-model-descriptor.md): Returns the descriptor for one model identifier. The response includes ownership, readiness status, and public limits. The endpoint returns `404` when the model is not available.
- [Create a reusable choice catalogue.](https://docs.quackpay.com.br/api-reference/catalogs/create-a-reusable-choice-catalogue.md): Creates a named catalog that can be referenced by ID from future decision requests. Catalog IDs are unique within the caller's namespace. Catalog writes require a bearer API key.
- [Read a catalogue you own.](https://docs.quackpay.com.br/api-reference/catalogs/read-a-catalogue-you-own.md): Returns the current definition of a catalog available to the authenticated caller, including its model, choices, version, and visibility.
- [Delete a catalogue you own.](https://docs.quackpay.com.br/api-reference/catalogs/delete-a-catalogue-you-own.md): Permanently removes a catalog available to the authenticated caller. Existing decision records are not changed, but future requests cannot reference the deleted ID.
- [Check process liveness.](https://docs.quackpay.com.br/api-reference/health/check-process-liveness.md): Returns a minimal live status when the API process is running. Use this endpoint for a process-level liveness check rather than an inference readiness check.
- [Check inference readiness.](https://docs.quackpay.com.br/api-reference/health/check-inference-readiness.md): Returns a ready status when the API and an inference worker can accept requests. A `503` response means the service is temporarily unavailable or the worker is not ready.
- [Errors](https://docs.quackpay.com.br/resources/errors.md): Interpret Goldenfish HTTP errors and decide whether to fix, retry, or escalate a request.
- [Rate limits and retries](https://docs.quackpay.com.br/resources/rate-limits.md): Handle rate, concurrency, and quota responses without overwhelming the API.
- [Changelog](https://docs.quackpay.com.br/resources/changelog.md): Contract and documentation changes for the Aspas Labs API.
- [Glossary](https://docs.quackpay.com.br/resources/glossary.md): Definitions for the terms used throughout the Goldenfish API documentation.

## OpenAPI Specs

- [openapi](/openapi.json)

## Optional

- [Aspas Labs](https://aspaslabs.com/)
- [GitHub](https://github.com/j6aoo/aspas-labs)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.