# HipChat REST API v2

**Canonical:** https://apis.io/apis/hipchat/hipchat-rest-api-v2/  
**Provider:** HipChat — https://apis.io/providers/hipchat/  
**Documentation:** https://developer.atlassian.com/server/hipchat/about-the-hipchat-rest-api/

HipChat REST API v2 is one of 2 APIs that [HipChat](https://apis.io/providers/hipchat/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Chat, Rooms, Message, User, and Notification. The published artifact set on APIs.io includes API documentation, an API reference, an OpenAPI specification, authentication docs, rate-limit docs, a getting-started guide, and 4 JSON Schemas.

The HipChat REST API v2 was the primary developer surface for the team chat platform, exposing rooms, users, messages, notifications, emoticons, OAuth sessions, add-on capabilities, and webhook management. Authentication supported four token types (add-on tokens, user tokens, personal access tokens, and room notification tokens) passed as either an auth_token query parameter or an Authorization Bearer header. The API was retired on February 15, 2019 alongside the rest of the HipChat product line.

## Machine-readable artifacts (24)

- **Documentation** — https://developer.atlassian.com/server/hipchat/about-the-hipchat-rest-api/
- **APIReference** — https://www.hipchat.com/docs/apiv2
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/openapi/hipchat-rest-api-openapi.yml
- **Authentication** — https://developer.atlassian.com/server/hipchat/auth/
- **RateLimits** — https://developer.atlassian.com/server/hipchat/hipchat-rest-api-rate-limits/
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/rate-limits/hipchat-rate-limits.yml
- **Security** — https://developer.atlassian.com/server/hipchat/hipchat-rest-api-scopes/
- **GettingStarted** — https://developer.atlassian.com/server/hipchat/getting-started-with-atlassian-connect-for-hipchat/
- **SDKs** — https://github.com/hipchat/hipchat-php
- **SDKs** — https://github.com/hipchat/hipchat-rb
- **SDKs** — https://github.com/hipchat/hubot-hipchat
- **CLI** — https://github.com/hipchat/hipchat-cli
- **Integrations** — https://github.com/hipchat/redmine_hipchat
- **Integrations** — https://github.com/hipchat/triatomic
- **GitHubOrganization** — https://github.com/hipchat
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/json-schema/hipchat-room-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/json-schema/hipchat-user-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/json-schema/hipchat-message-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/json-schema/hipchat-webhook-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/json-ld/hipchat-context.jsonld
- **Versioning** — https://developer.atlassian.com/server/hipchat/hipchat-connect-versioning/
- **Sunset** — https://www.atlassian.com/blog/announcements/new-atlassian-slack-partnership
- **Sunset** — https://www.atlassian.com/migration/move-from-hipchat-to-slack
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/hipchat/refs/heads/main/apis.yml

## Other HipChat APIs (1)

- [HipChat Webhooks API](https://apis.io/apis/hipchat/hipchat-webhooks-api/)

## Tags

Chat, Rooms, Message, User, Notification, Webhook, Authentication, Sunset

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hipchat/hipchat-rest-api-v2/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hipchat/.