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
(Ignored)
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.

CanCreateTopicGroup
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
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.…
BasicChannelBase
object
Object containing basic details about the channel.
29 properties
Bot
DefaultChannelGroup
object
Dictionary containing details of a default channel group.
4 properties
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…
MissingArgumentError
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…
Subscription
object
41 properties
Reminder
object
Object containing details of the scheduled message.
8 properties 8 required
CodedErrorBase
RealmEmoji
object
Object containing details about an emoji. It has the following properties:
6 properties
CanRemoveSubscribersGroup
Draft
object
A dictionary for representing a message draft.
6 properties 4 required
CanDeleteAnyMessageGroup
BadEventQueueIdError
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
UserGroup
object
Object containing the user group's attributes.
15 properties
RealmExport
object
Object containing details about a [data export](/help/export-your-organization).
8 properties
ScheduledMessageBase
object
Object containing details of the scheduled message.
8 properties 7 required
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…
ScheduledMessage
CanMoveMessagesOutOfChannelGroup
Attachment
object
Dictionary containing details of a file uploaded by a user.
6 properties
EmojiReaction
OnboardingStep
object
Dictionary containing details of a single onboarding step.
2 properties
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…
CanAdministerChannelGroup
EventIdSchema
integer
The ID of the event. Events appear in increasing order but may not be consecutive.
CanResolveTopicsGroup
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
CodedError
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 =…
ChannelCanAddSubscribersGroup
CanDeleteOwnMessageGroup
RealmPlayground
object
Object containing details about a realm playground.
4 properties
ChannelFolder
object
Object containing the channel folder's attributes.
8 properties
RealmDeactivatedError
InvalidApiKeyError
UserDeactivatedError
IncompatibleParametersError
ModernPresenceFormat
object
{userid}: Presence data (modern format) for the user with the specified ID.
2 properties
RateLimitedError
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
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…
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…
BasicBot
MessagesBase
object
Object containing details of the message.
22 properties
GroupSettingValue
SavedSnippet
object
Object containing the details of the saved snippet.
4 properties
UserNotAuthorizedError
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).
EmojiReactionEvent
User
MessagesEvent
CanSubscribeGroup
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…
RealmDomain
object
2 properties 2 required
EmojiBase
object
3 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…
JsonResponseBase
object
1 property
JsonSuccess
BasicBotBase
object
5 properties
CustomProfileField
object
Dictionary containing the details of a custom profile field configured for this organization.
10 properties 7 required
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).
CanMoveMessagesWithinChannelGroup
BasicChannel
CanSendMessageGroup
UserStatus
object
5 properties
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…
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

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.