Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zulip invites API

The invites API from Zulip — 5 operation(s) for invites.

Zulip invites API is one of 17 APIs that Zulip publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include invites. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 6 operations across 5 paths, and defines 10 schemas. It is described by OpenAPI 3.0.1, at version 1.0.0.

Requests are made against 5 base URLs: https://{subdomain}.zulipchat.com/api/v1, {server}/api/v1, https://chat.zulip.org/api/v1, http://localhost:9991/api/v1, http://{subdomain}.testserver/json.

6 operations 5 paths 10 schemas 2 DELETE1 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0.0
Servers
https://{subdomain}.zulipchat.com/api/v1
{server}/api/v1
https://chat.zulip.org/api/v1
http://localhost:9991/api/v1
http://{subdomain}.testserver/json
Authentication
HTTP Basic
License
Resource Areas
1

Authentication & Security 1

Zulip invites API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (BasicAuth). By default, every request must be authenticated.

  • BasicAuth — Basic authentication, with the user's email as the username, and the API key as the password. The API key can be fetched using the /fetchapikey or /devfetchapi…

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 2 DELETE, 1 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

invites 6
GET
/invites
Get all invitations
get-invites → 200
POST
/invites
Send invitations
send-invites body → 200400
POST
/invites/multiuse
Create a reusable invitation link
create-invite-link body → 200400
DELETE
/invites/{invite_id}
Revoke an email invitation
revoke-email-invite 1 param → 200400
DELETE
/invites/multiuse/{invite_id}
Revoke a reusable invitation link
revoke-invite-link 1 param → 200400
POST
/invites/{invite_id}/resend
Resend an email invitation
resend-email-invite 1 param → 200400

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are Invite (9 properties), JsonResponseBase (1 property). Each schema is shown below with its type and property counts.

JsonSuccessBase
Changes: As of Zulip 7.0 (feature level 167), if any parameters sent in the request are not supported by this endpoint, a successful JSON response will include…
InviteRoleParameter
integer
The [organization-level role](/api/roles-and-permissions) of the user that is created when the invitation is accepted. Possible values are: - 100 = Organizatio…
JsonSuccess
InviteExpirationParameter
integer
The number of minutes before the invitation will expire. If null, the invitation will never expire. If unspecified, the server will use a default value (based…
IgnoredParametersUnsupported
array
An array of any parameters sent in the request that are not supported by the endpoint. See [error handling](/api/rest-error-handlingignored-parameters) documen…
JsonResponseBase
object
1 property
InvitationFailedError
CodedError
CodedErrorBase
Invite
object
A dictionary containing details about an [invitation](/help/invite-new-users).
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zulip-invites-api-openapi.yml Raw ↑

Other APIs Zulip publishes across the network.

Zulip REST API
Zulip Events API
Zulip Webhooks
Zulip authentication API
Zulip bots API
Zulip channels API
Zulip drafts API
Zulip messages API
Zulip mobile API
Zulip navigation_views API
Zulip real_time_events API
Zulip reminders API