# Forgium Agent public integration documentation

- Documentation manifest version: 38
- Public contract version: 7.0.0
- Published on: 2026-09-11
- 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-quickstart
9. /docs/integration/capability-handoff
10. /docs/integration/agent-policy
11. /docs/integration/diagnostics
12. /docs/integration/auth
13. /docs/integration/errors
14. /docs/integration/idempotency
15. /docs/integration/token-rotation
16. /docs/integration/privacy-and-retention
17. /docs/integration/compatibility-and-versioning
18. /docs/integration/migrate-agent-contract-4-to-5
19. /docs/integration/prompt-integrations
20. /docs/integration/api.openapi.yaml
21. /docs/integration/prompt-integrations-example-foda
22. /docs/integration/prompt-integration-agent-prompt

## 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 import validation and final chat verification.

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