diff --git a/src/spec/paths/empire.ts b/src/spec/paths/empire.ts index 9b02f93..becca9f 100644 --- a/src/spec/paths/empire.ts +++ b/src/spec/paths/empire.ts @@ -1623,22 +1623,46 @@ export const empire = { ), responses: { - ...response200('Removes sitters from being permitted to sit this account.', { - type: 'object', - required: ['status'], - properties: { status: statusSchema() }, - }), + ...response200( + 'Removes sitters from being permitted to sit this account. Returns the same list as view_authorized_sitters.', + { + type: 'object', + required: ['sitters', 'status'], + properties: { + sitters: { + type: 'array', + items: { + type: 'object', + required: ['id', 'name', 'expiry'], + properties: { + id: { type: 'integer' }, + name: { type: 'string' }, + expiry: { type: 'string' }, + }, + }, + }, + status: statusSchema(), + }, + } + ), ...response500(), }, ...requestBodySchema({ type: 'object', - required: ['empires'], + description: 'Either `empires` or `deauthorize_all` must be provided.', properties: { empires: { type: 'array', items: { type: 'string' }, - description: 'The ids (not names) of specific empires being removed.', + description: + 'The ids (not names) of specific empires being removed. Takes precedence over deauthorize_all.', + }, + deauthorize_all: { + type: 'integer', + enum: [1], + description: + 'Removes every authorized sitter. Ignored if empires is given. Any value (even 0) is treated as true, so omit it rather than sending 0.', }, }, }), diff --git a/src/spec/paths/inbox.ts b/src/spec/paths/inbox.ts index 51a023c..1d70a81 100644 --- a/src/spec/paths/inbox.ts +++ b/src/spec/paths/inbox.ts @@ -395,7 +395,7 @@ export const inbox = { }, }, }, - return_ids: { + save_ids: { type: 'boolean', description: 'When true, the trashed message ids are gathered and returned in `deleted`. Off by default, since gathering them adds server work and response size; `deleted_count` is returned either way.', @@ -413,7 +413,7 @@ export const inbox = { deleted: { type: 'array', items: { type: 'integer' }, - description: 'Only present when return_ids is true.', + description: 'Only present when save_ids is true.', }, deleted_count: { type: 'integer' }, status: statusSchema(),