# Forgium Agent public integration documentation

- Documentation manifest version: 12
- Public contract version: 2.0.0
- Published on: 2026-07-31
- Canonical agent entrypoint: /docs/integration/use-with-an-agent
- Manual entrypoint: /docs/integration/getting-started
- Machine-readable manifest: /agent-manifest.json

## Read order
1. /docs/integration/use-with-an-agent
2. /docs/integration/overview
3. /docs/integration/environments
4. /docs/integration/request-access
5. /docs/integration/contract-retrieval
6. /docs/integration/getting-started
7. /docs/integration/reference-implementation
8. /docs/integration/capability-handoff
9. /docs/integration/auth
10. /docs/integration/errors
11. /docs/integration/idempotency
12. /docs/integration/api.openapi.yaml

## Route selection
- Connectivity only: use the HTTP quickstart; do not inspect an unrelated repository.
- HTTP integration: use POST /v1/channels/http/messages and the OpenAPI contract.
- Host data or actions: follow the capabilities lifecycle through chat verification.

## Contracts and guides
- HTTP and capabilities OpenAPI: /docs/integration/api.openapi.yaml
- HTTP quickstart: /docs/integration/getting-started.md
- HTTP integration reference: /docs/integration/reference-implementation.md
- Contract retrieval: /docs/integration/contract-retrieval.md
- Capabilities lifecycle: /docs/integration/capability-handoff.md
- Environment isolation: /docs/integration/environments.md
- Request access: /docs/integration/request-access.md

## Stop conditions
- Do not guess or enumerate undocumented OpenAPI, Swagger, API, or internal URLs.
- Stop when the access bundle, canonical contract, or selected route guide is unavailable.
- Do not claim capabilities are active without activation and final chat verification.

## Skill distribution
- Status: not-installable
- No installation command or package URL is advertised.
- Use the universal agent entrypoint instead.