How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zulip Real Time Events API

The real_time_events API from Zulip — 4 operation(s) for real_time_events.

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

Tagged areas include Real-Time Events. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 4 paths, and defines 72 schemas. It is described by OpenAPI 3.2.0, 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.

5 operations 4 paths 72 schemas 1 DELETE1 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
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 Real Time Events 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 5

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

Real-Time Events 5
GET
/events
Get events from an event queue
get-events 3 params → 200400
DELETE
/events
Delete an event queue
delete-queue body → 200400
POST
/register
Register an event queue
register-queue body → 200
POST
/real-time
Create real time
postRealTime body → 200
POST
/rest-error-handling
Error handling
rest-error-handling → 400401429

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are Subscription (41 properties), BasicChannelBase (29 properties), MessagesBase (22 properties), UserBase (18 properties). Each schema is shown below with its type and property counts.

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…
UserDeactivatedError
MessagesBase
object
Object containing details of the message.
22 properties
LegacyPresenceFormat
object
{clientname} or "aggregated": Object containing the details of the user's presence. Changes: Starting with Zulip 7.0 (feature level 178), this will always cont…
4 properties
EmojiBase
object
3 properties
RealmDomain
object
2 properties 2 required
EventIdSchema
integer
The ID of the event. Events appear in increasing order but may not be consecutive.
User
CanMoveMessagesOutOfChannelGroup
UserStatus
object
5 properties
GroupSettingValue
AllPublicChannels
boolean
Whether you would like to request message events from all public channels. Useful for workflow bots that you'd like to see all new messages sent to public chan…
BadEventQueueIdError
ChannelCanAddSubscribersGroup
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…
CodedError
CanAdministerChannelGroup
JsonSuccess
CustomProfileField
object
Dictionary containing the details of a custom profile field configured for this organization.
10 properties 7 required
BasicChannel
Event_types
array
A JSON-encoded array indicating which types of events you're interested in. Values that you might find useful include: - message (messages) - subscription (cha…
EmojiReaction
Reminder
object
Object containing details of the scheduled message.
8 properties 8 required
ScheduledMessageBase
object
Object containing details of the scheduled message.
8 properties 7 required
RealmAuthenticationMethod
object
Dictionary describing the properties of an authentication method for the organization - its enabled status and availability for use by the organization.
3 properties
ScheduledMessage
Bot
InvalidApiKeyError
GroupPermissionSetting
object
Configuration for a group permission setting specifying the groups to which the setting can be set to and the default values for the setting. Changes: Removed…
7 properties
BasicChannelBase
object
Object containing basic details about the channel.
29 properties
CodedErrorBase
CanSendMessageGroup
CanRemoveSubscribersGroup
NavigationView
object
Represents a user's personal configuration for a specific navigation view (displayed most visibly at the top of the web application's left sidebar). Navigation…
3 properties 2 required
MissingArgumentError
CanMoveMessagesWithinChannelGroup
WebhookUrlOption
array
An array of optional URL parameter options for the incoming webhook integration. In the web app, these are used when [generating a URL for an integration](/hel…
WebhookConfigOption
array
An array of configuration options that can be set when creating a bot user for this incoming webhook integration. This is an unstable API. Please discuss in ch…
OnboardingStep
object
Dictionary containing details of a single onboarding step.
2 properties
SavedSnippet
object
Object containing the details of the saved snippet.
4 properties
CanResolveTopicsGroup
RateLimitedError
Draft
object
A dictionary for representing a message draft.
6 properties 4 required
RealmDeactivatedError
BasicBotBase
object
5 properties
RealmExport
object
Object containing details about a [data export](/help/export-your-organization).
8 properties
BotConfiguration
object
A dictionary of string key/value pairs, which describe the configuration for the bot. These are usually details like API keys, and are unique to the integratio…
MessagesEvent
ProfileData
object
Only present if isbot is false; bots can't have custom profile fields. A dictionary containing custom profile field data for the user. Each entry maps the inte…
UserGroup
object
Object containing the user group's attributes.
15 properties
UserNotAuthorizedError
EmojiReactionEvent
CanSubscribeGroup
CanCreateTopicGroup
CanDeleteAnyMessageGroup
UserBase
object
A dictionary containing basic data on a given Zulip user. Changes: Removed isbillingadmin field in Zulip 10.0 (feature level 363), as it was replaced by the ca…
18 properties
IncompatibleParametersError
RealmPlayground
object
Object containing details about a realm playground.
4 properties
EmailAddressVisibility
integer
The [policy][permission-level] for [which other users][help-email-visibility] in this organization can see the user's real email address. - 1 = Everyone - 2 =…
TopicsPolicy
string
Whether [named topics](/help/introduction-to-topics) and the empty topic (i.e., ["general chat" topic](/help/general-chat-topic)) are enabled in this channel.…
JsonResponseBase
object
1 property
Subscription
object
41 properties
BasicBot
ChannelFolder
object
Object containing the channel folder's attributes.
8 properties
Narrow
array
A JSON-encoded array of arrays of length 2 indicating the [narrow filter(s)](/api/construct-narrow) for which you'd like to receive events for. For example, to…
DefaultChannelGroup
object
Dictionary containing details of a default channel group.
4 properties
EventTypeSchema
string
The event's type, relevant both for client-side dispatch and server-side filtering by event type in [POST /register](/api/register-queue).
Attachment
object
Dictionary containing details of a file uploaded by a user.
6 properties
ModernPresenceFormat
object
{userid}: Presence data (modern format) for the user with the specified ID.
2 properties
FolderId
integernull
The ID of the folder to which the channel belongs. Is null if channel does not belong to any folder. Changes: New in Zulip 11.0 (feature level 389).
CanDeleteOwnMessageGroup
RealmEmoji
object
Object containing details about an emoji. It has the following properties:
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zulip-real-time-events-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 Invites API
Zulip Messages API
Zulip Mobile API
Zulip Navigation Views API
Zulip Reminders API
Where this information came from

This is an independent, third-party profile of Zulip Real Time Events API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.