## Current API shape

**Base URL:** `https://api.useagents.site` REST endpoints such as `/tools/search` are currently unversioned. The goal is to keep existing clients working as the platform changes.

## Versioning strategy

- **Backward compatibility**: Avoid breaking changes to existing response structures and parameters.
- **New features**: Add optional fields in a way that does not break existing clients.
- **Deprecation**: Provide notice and migration guidance before making required changes.

## Integration guidance

- Build clients that tolerate new optional fields in responses.
- Avoid assuming field order in JSON responses.
- Watch changelogs and announcements for deprecations or migration guidance.
- Test integrations when platform changes are announced.