paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-10-29 11:03:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

api_docs: Add "Principals" component.

Browse Source 
To facilitate re-use of the same parameters in other paths, this commit
store the content of the parameter "principals" in components.
This commit is contained in:
shubhamgupta2956
2020-04-22 01:57:56 +05:30
committed by Tim Abbott
parent c4ebe98bba
commit db3d95fd16
1 changed files with 15 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
zerver/openapi/zulip.yaml
View File

@@ -1830,18 +1830,7 @@ paths:
type: boolean
default: false
example: true
- name: principals
in: query
description: |
A list of email addresses of the users that will be subscribed to the
streams specified in the `subscriptions` argument. If not provided, then
the requesting user/bot is subscribed.
schema:
type: array
items:
type: string
default: []
example: ['ZOE@zulip.com']
- $ref: '#/components/parameters/Principals'
- name: authorization_errors_fatal
in: query
description: |
@@ -2039,17 +2028,7 @@ paths:
type: string
example: ['Verona', 'Denmark']
required: true
- name: principals
in: query
description: |
A list of email addresses of the users that will be unsubscribed from
the streams specified in the `subscriptions` argument. If not provided,
then the requesting user/bot is unsubscribed.
schema:
type: array
items:
type: string
example: ['ZOE@zulip.com']
- $ref: '#/components/parameters/Principals'
responses:
'200':
description: Success.
@@ -3834,3 +3813,16 @@ components:
type: boolean
default: false
example: true
Principals:
name: principals
in: query
description: |
A list of email addresses of the users that will be subscribed/unsubscribed
to the streams specified in the `subscriptions` argument. If not provided, then
the requesting user/bot is subscribed.
schema:
type: array
items:
type: string
default: []
example: ['ZOE@zulip.com']