> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/internal-api/welcome.md).

# Introduction

The Adaptria Public API exposes the full Adaptria operational catalogue so that internal teams and connector integrations can drive projects programmatically. This documentation is written for the **internal audience**: project managers, internal staff and the connector integrations that seed work into Adaptria on their behalf.

## Who this is for

You hold an internal or connector API credential with broader scope than a client key. Where a client key is limited to submitting RFQs and approving quotes, an internal key can read across companies, gather catalogue data and create projects directly.

## The broader catalogue

Beyond the RFQ, quote and project flow, your credential can reach the wider operational surface:

* **Projects**: create projects directly with `POST /api/public/v1/projects`, and list, retrieve and read deliverables.
* **Jobs**: browse and manage the individual jobs that make up a project.
* **Teams, Clients, Items, Attributes**: the organisational and configuration entities behind every project.
* **Services & Client Services**: the global service catalogue and per-client service mappings.
* **Pricelists & Workflows**: pricing data and the workflow definitions that govern delivery.
* **Finance**: receivables and payables.
* **Users**: the internal staff directory.

RFQs and quotes are available as **read-only triage views** for your audience. RFQ creation and quote accept/decline are client actions, performed via the client API or the portal.

## Creating a project

The core internal flow is `POST /api/public/v1/projects`. You gather the catalogue IDs your project references (company, services, languages or markets), optionally upload source assets, and submit a project that lands in **Draft** status for a project manager to enrich and action.

This endpoint supports the `Idempotency-Key` header so retries from an external system are safe. See [Idempotency-Key conventions](/internal-api/idempotency.md).

## Next steps

* Follow the [Quickstart](/internal-api/quickstart-connector.md) to build a connector that creates an Adaptria project.
* Browse the [API Reference](/internal-api/reference.md) for the full catalogue of endpoints.
* To receive real-time events, see [Webhooks](/internal-api/webhooks.md).