# API Integration Brief (template from daniilmaximkin.com)

## Systems and task

- Systems involved:
- Trigger (what starts an exchange):
- What "done" looks like for one instance of it:

## Source of truth and fields

| Field | Owner (source of truth) | Direction | Cadence | Idempotency key |
|---|---|---|---|---|
| | | | | |
| | | | | |
| | | | | |
| | | | | |

## Authorisation

- Who owns the credentials on each side:
- Where credentials are stored:
- Who can revoke access if the integration needs to be turned off:

## Errors and responsibility

- What counts as a retryable failure vs. a permanent one:
- Where a run goes after it exhausts its retries (dead-letter path):
- Who is notified when that happens, and how:

## Acceptance criteria

- [ ]
- [ ]
- [ ]
- [ ]
- [ ]

## What this brief does not decide

- Price and timeline: agreed separately once the sections above are filled; not part of this document.
- Notes on approach (webhook vs. polling vs. scheduled export), if not already implied by cadence above:
- Anything explicitly out of scope: