---
title: "Overview"
description: "Agent Deployments is the system of record for every deployed AI agent. Every catalog entry, every match, and every cost estimate reads from this data."
url: "https://nexora.apim.eu/apis/agent-deployments/docs/overview"
image: "https://nexora.apim.eu/_og/d/c_Ocean.takumi,title_Overview,description_~QWdlbnQgRGVwbG95bWVudHMgaXMgdGhlIHN5c3RlbSBvZiByZWNvcmQgZm9yIGV2ZXJ5IGRlcGxveWVkIEFJIGFnZW50LiBFdmVyeSBjYXRhbG9nIGVudHJ5LCBldmVyeSBtYXRjaCwgYW5kIGV2ZXJ5IGNvc3QgZXN0aW1hdGUgcmVhZHMgZnJvbSB0aGlzIGRhdGEu,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiIzM5RkYxNCJ9fX0,p_Ii9hcGlzL2FnZW50LWRlcGxveW1lbnRzL2RvY3Mvb3ZlcnZpZXci,s_i4VRqK5FvZD4WbuU.png"
---

# Overview

Agent Deployments is the system of record for every deployed AI agent. Every catalog entry, every match, and every cost estimate reads from this data.

## [Data model](#data-model)

A deployment combines master data (agent type, title, owning team), key figures (integration count, tool count, model/provider), commercial details (cost per 1k tokens or monthly budget, chargeback rate), and compliance-certification figures. Artifacts - model cards, evaluation reports, architecture diagrams - attach to the deployment, not to a catalog entry, and are therefore available to every document generated later.

## [Lifecycle](#lifecycle)

`draft` → `active` → `paused` → `retired` or `superseded` → `archived`

Archived deployments remain readable. There's no true deletion, because settlements and disclosures reference them.

## [Agent metadata feed](#agent-metadata-feed)

`POST /import/feed` accepts JSON or a ZIP of agent cards. In `merge` mode, only the deployments in the file are created or updated; `replace` additionally archives anything not in the file. For a nightly sync from an existing agent registry, `replace` is the right mode - but only once the export is verifiably complete.

## [Common Mistakes](#common-mistakes)

-   **Business unit as free text.** `business_unit` should reference a known cost-center ID; leading zeros in cost-center codes are otherwise lost.
-   **Compliance certification added later.** Optional at creation, but publishing any catalog entry fails without it.
-   **Missing model card.** Without `category: "model_card"`, the template falls back to a placeholder graphic.