docs: account_id override for DELETE /api/artists/{id} and GET /api/chats/{id}/messages
Merged
SW
4mo ago+28+28+01234567890123456789-0-0-0123456789
Contract for the admin account-override work tracked in recoupable/chat#1811. Documents the optional account_id override on the first two flagged endpoints so the docs land before the API implementations.
What changed
DELETE /api/artists/{id} (releases.json)
- Adds an optional
account_idrequest body (UUID) โ lets a caller with multi-account access (org members / Recoup admins) delete an artist in another account's context. - Adds a
400response for an invalidaccount_idUUID. - Updates the endpoint description.
GET /api/chats/{id}/messages (research.json)
- Adds an optional
account_idquery param (camelCaseaccountIdalias also accepted) โ lets a caller read another account's chat messages. - Broadens the
400description to cover an invalidaccount_id. - Updates the endpoint description.
Both mirror the existing override docs on POST /api/artists (body) and GET /api/artists (query). Diffs are additive; both JSON specs validate.
Merge order
This docs PR lands first, then the two API PRs:
- ๐ docs (this PR) โ
main - โ๏ธ
DELETE /api/artists/{id}override โ apitest - โ๏ธ
GET /api/chats/{id}/messagesoverride โ apitest
Tracking issue: recoupable/chat#1811
Summary by cubic
Adds docs for an optional account_id override on DELETE /api/artists/{id} so org/admin users can delete an artist in another accountโs context. Also documents a 400 error for an invalid account_id UUID.
- New Features
- DELETE /api/artists/{id}: optional account_id in JSON body; 400 for invalid UUID.