Yago González
7ddc6e8d10
api docs: Migrate POST /messages to OpenAPI.
2018-07-26 10:24:01 -07:00
Yago González
cb24756edc
api docs: Merge docs for sending stream and private messages.
2018-07-26 10:24:01 -07:00
Yago González
fa2daf0044
api docs: Migrate POST /users/me/subscriptions to OpenAPI.
2018-07-03 20:15:34 +02:00
Yago González
bba8b88707
api docs: Explain clearly how to create new streams.
...
Tweaked significantly by tabbott to cover this more clearly.
2018-07-01 08:41:37 -07:00
Eeshan Garg
0a43e5e257
Replace all user-facing references to "invite-only" with "private".
...
Fixes #9611 .
2018-06-12 13:37:45 -04:00
Yago González
d87f0ccb4e
api docs: Show Yes/No in the "Required" field of the args table.
2018-05-25 23:31:30 +02:00
Tim Abbott
be3804f505
api: Fix incorrectly documented event types.
...
It's actually "subscription" and "message" (neither is plural).
While we're at it, we should also remove the "pointer" event type,
since that's of generally low interest.
2018-04-27 15:16:24 -07:00
Eeshan Garg
ea7ce7e0da
api docs: Ensure consistent formatting for arguments.json.
...
Ideally, there should be a space after every `:`.
Note that the JSON isn't displayed as is but is formatted as an
HTML table.
2018-03-02 09:44:17 -08:00
Eeshan Garg
ce56ee80e7
api_docs: Document the `POST /api/v1/user_uploads` endpoint.
...
Fixes #1353 .
2018-03-02 09:44:17 -08:00
Eeshan Garg
a14b52ef1d
api docs: Document the `DELETE /users/me/subscriptions` endpoint.
...
Note that there is currently no JavaScript method in zulip-js
to call this endpoint.
2018-01-12 07:30:38 -05:00
Eeshan Garg
1b3b907694
delete-queue.md: Specify queue_id as a required argument.
...
Specifying it as an optional one was a mistake.
2018-01-12 07:30:38 -05:00
Eeshan Garg
8c723e8c27
api docs: Document the POST /api/v1/users endpoint.
...
Note that there is no JavaScript equivalent for requesting this
endpoint in zulip-js yet.
2018-01-12 07:30:38 -05:00
Eeshan Garg
a01f8c088a
api docs: Document the POST /api/v1/users/me/subscriptions endpoint.
...
There is a JavaScript equivalent for this endpoint but the npm
package has not yet been released.
2018-01-07 15:19:51 -05:00
Eeshan Garg
045aacbc67
api docs: Document the PATCH /api/v1/messages/<msg_id> endpoint.
...
Note that there is no JavaScript equivalent for requesting this
endpoint in zulip-js yet.
2018-01-07 15:19:51 -05:00
Eeshan Garg
6f01b042a1
api docs: Document the DELETE /api/v1/events endpoint.
...
Note that there is no JavaScript equivalent for requesting this
endpoint in zulip-js yet.
2018-01-07 15:19:51 -05:00
Eeshan Garg
1fd71287d6
api docs: Document the GET /api/v1/events endpoint.
2018-01-04 10:17:29 -05:00
Eeshan Garg
f620525373
api docs: Document the POST /api/v1/register endpoint.
2018-01-03 12:23:30 -05:00
Eeshan Garg
b73c60a135
api docs: Document the GET /api/v1/users endpoint.
2017-12-30 11:03:23 -05:00
Eeshan Garg
b31bdf23ca
api docs: Document the POST /api/v1/messages/render endpoint.
...
Note that currently, there is no way to interface with this
endpoint using zulip-js.
2017-12-30 11:03:23 -05:00
Eeshan Garg
cf8a8c8811
api docs: Document the GET /api/v1/get_stream_id endpoint.
...
This commit documents the /api/v1/get_stream_id endpoint.
Note that there is currently no way to interface with this
endpoint with zulip-js.
2017-12-30 11:03:23 -05:00
Eeshan Garg
e769a7eed2
api docs: Document the get-streams endpoint.
...
This commit documents the get-streams endpoint, which can be
by making a GET request to /api/v1/streams.
Note that in the code examples, JavaScript is missing an example
for how to pass in the `include_` query parameters. That is
because zulip-js's client.streams.retrieve function doesn't take
any arguments and zulip-js does not export any function equivalent
to client.call_endpoint in python-zulip-api/zulip.
2017-12-29 17:03:36 -05:00
Eeshan Garg
89f622937d
api docs: Generate Arguments table from JSON.
...
This commit does the following:
* Move the Arguments table data from stream-message.md and
private-message.md to a JSON file.
* Add a Markdown extension that allows one to include and render
a table from a JSON file like so:
{generate_arguments_table|arguments.json|private-stream.md}
* Use Bootstrap's .table class to format the table instead of
relying on custom CSS.
2017-12-29 17:03:36 -05:00