# Accordo API

**Canonical:** https://apis.io/apis/accordo-dev/accordo-dev-api/  
**Provider:** Accordo — https://apis.io/providers/accordo-dev/  
**Documentation:** https://github.com/khaoss85/agent-crm/blob/main/docs/API.md

Accordo API is one of 2 APIs that [Accordo](https://apis.io/providers/accordo-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Accordo API as documented publicly: 21 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/admin/metrics` | Authenticated tenant record counts ( records.read ). Not present on /health . |
| GET | `/api/approvals` | List approval requests |
| POST | `/api/approvals/{id}/approve` | Approve through workflow |
| POST | `/api/approvals/{id}/reject` | Reject through workflow |
| GET | `/api/audit` | List audit events |
| GET | `/api/companies` | List/create companies |
| POST | `/api/companies` | List/create companies |
| POST | `/api/contacts` | List/create contacts |
| POST | `/api/demo/seed` | Seed the demonstration data |
| GET | `/api/modules/{module}` | Generated-module metadata (fields, capabilities, paths) |
| GET | `/api/modules/{module}/records` | List generated-module records ( ?limit= strict integer 1–500; optionally narrowed by ?filter.<field>=<value> — ADR-008 addendum 2) |
| POST | `/api/modules/{module}/records` | Create a record (201) through the generated service |
| GET | `/api/modules/{module}/records/{id}` | Get a record |
| PATCH | `/api/modules/{module}/records/{id}` | Update supplied fields |
| POST | `/api/modules/{module}/records/{id}/actions/{action}` | Run a code-first record action (ADR-011) |
| POST | `/api/opportunities` | List/create opportunities |
| POST | `/api/opportunities/{id}/stage` | Run the stage-change workflow |
| GET | `/api/schema` | Agent-readable CRM schema, including bounded storage: {adapter, available} |
| GET | `/api/traces` | List workflow runs |
| GET | `/api/traces/{id}` | Run with step spans |
| GET | `/health` | Bounded process liveness and storage adapter posture. Does not read tenant records. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/accordo-dev/openapi/_ae-authored/accordo-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-get-api-admin-metrics-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-get-api-modules-module-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-post-api-modules-module-records-id-actions-action-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-get-api-schema-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-get-health-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/accordo-dev/json-schema/accordo-dev-post-api-contacts-request-schema.json

## Other Accordo APIs (1)

- [Accordo API](https://apis.io/apis/accordo-dev/accordo-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/accordo-dev/accordo-dev-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/accordo-dev/.