# API / contract: [name]

## Ownership and status

- Producer / owning team or module:
- Consumers:
- Current or proposed:
- Canonical machine-readable schema (OpenAPI/protobuf/etc.):

## Transport and compatibility

- HTTP/gRPC/events:
- Versioning and deprecation policy:
- Authentication and authorization (including tenant scope if relevant):

## Operations

| Operation / event | Input schema | Output / error schema | Permission / ownership |
|---|---|---|---|
| [name] | [link] | [link] | [policy] |

## Failure and limits

- Validation errors and status codes:
- Idempotency / retries / rate limits:
- Pagination / ordering / timeouts:
- Event ordering / delivery guarantees, if relevant:

## Tests and changes

- Contract tests:
- Compatibility constraints:
- Related ADR / migration plan: