# SDKs and AI coding agents

Supported Go and TypeScript clients are generated from the same reviewed OpenAPI
document used by contract checks. Pin SDK versions and review the public
changelog before upgrading.

For coding agents:

1. Use [OpenAPI 3 JSON](./v1/openapi.json) as the operation and schema authority.
2. Use these Markdown guides for authentication, compatibility, and retry policy.
3. Reference credentials by environment-variable or secret-store name.
4. Never request, paste, print, or commit an API-key value.
5. Preserve the generated operation IDs so code remains searchable across SDKs.

The public Swagger UI is intentionally read-only. Execute requests from a
server-side development environment or the authenticated Portal console.