# Bronjoy Api-spec API

**Canonical:** https://apis.io/apis/bronjoy-com/bronjoy-api-spec-api/  
**Provider:** Bronjoy — https://apis.io/providers/bronjoy-com/  
**Base URL:** https://api.bronjoy.com/api  
**Documentation:** https://docs.bronjoy.com/api-reference

Bronjoy Api-spec API is one of 2 APIs that [Bronjoy](https://apis.io/providers/bronjoy-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Bronjoy Api-spec API: 313 operations.

## Operations (60 of 313)

| Method | Path | Summary |
|---|---|---|
| GET | `/org/announcements` | List announcements for the organization |
| POST | `/org/announcements` | Create a new announcement |
| GET | `/org/announcements/{announcement}` | Get a single announcement |
| PUT | `/org/announcements/{announcement}` | Update an announcement |
| DELETE | `/org/announcements/{announcement}` | Delete an announcement |
| GET | `/org/appointments` | — |
| POST | `/org/appointments` | — |
| GET | `/org/appointments/pending` | — |
| GET | `/org/appointments/calendar` | — |
| POST | `/org/appointments/batch-update` | — |
| POST | `/org/appointments/batch-destroy` | — |
| GET | `/org/appointments/{appointment}` | — |
| PUT | `/org/appointments/{appointment}` | — |
| DELETE | `/org/appointments/{appointment}` | — |
| POST | `/org/appointments/{appointment}/submit` | — |
| POST | `/org/appointments/{appointment}/cancel` | — |
| POST | `/org/appointments/{appointment}/reschedule` | — |
| GET | `/org/schedule` | Get unified schedule - both recurring availabilities and one-time exceptions Supports my_schedule=true to filter to current user's schedule only |
| POST | `/org/schedule` | Store a new schedule entry |
| PUT | `/org/schedule/{id}` | Update a schedule entry |
| DELETE | `/org/schedule/{id}` | Delete a schedule entry |
| GET | `/org/availability` | — |
| PUT | `/org/availability` | — |
| GET | `/org/availability/exceptions` | — |
| POST | `/org/availability/exceptions` | — |
| POST | `/organization-profiles/{slug}/booking-requests` | Leave a booking request on a venue that takes no online bookings yet |
| GET | `/org/branches` | — |
| POST | `/org/branches` | — |
| GET | `/org/branches/{branch}` | — |
| PUT | `/org/branches/{branch}` | — |
| DELETE | `/org/branches/{branch}` | — |
| GET | `/calendar/callback/google` | Handle Google OAuth callback. Exchanges authorization code for tokens and redirects back to frontend |
| GET | `/org/calendar/connections` | List the current staff member's calendar connections |
| GET | `/org/calendar/auth-url` | Generate the OAuth authorization URL for connecting a provider |
| GET | `/org/calendar/feed-url` | Get the iCal feed URL for the current staff member |
| DELETE | `/org/calendar/connections/{connection}` | Disconnect a calendar connection and revoke tokens |
| PATCH | `/org/calendar/connections/{connection}/toggle` | Toggle push or pull sync for a connection |
| POST | `/org/calendar/connections/{connection}/sync` | Trigger an immediate sync for a calendar connection |
| GET | `/calendar/feed/{token}.ics` | Serve the iCal feed for a staff member. The token in the URL authenticates the request — no login needed |
| GET | `/categories` | List all categories with published organization counts and metadata. Used for the /categories index page |
| GET | `/categories/{slug}` | Get category landing page data: category details, city breakdown, sibling categories |
| GET | `/categories/{slug}/{city}` | Get category + city landing page data |
| GET | `/org/ai/conversations` | — |
| GET | `/org/ai/conversations/{conversation}` | — |
| DELETE | `/org/ai/conversations/{conversation}` | — |
| POST | `/org/ai/chat` | SSE streaming chat endpoint |
| GET | `/cities` | List all cities that have at least one published organization, with counts. Used for the /cities index page and the sitemap. Ordered by org count desc |
| GET | `/cities/{city}` | City landing page data: the city, its category breakdown, and top providers. The inverse of CategoryLandingController@showCity — "city → its categories + top... |
| GET | `/claims` | List the authenticated user's claim requests |
| POST | `/claims` | Submit a new claim request |
| GET | `/claims/{claimRequest}` | Show a single claim request belonging to the authenticated user |
| POST | `/claims/{claimRequest}/documents` | Attach additional documents to an open claim request |
| POST | `/claims/{claimRequest}/withdraw` | Withdraw a pending claim request |
| POST | `/claims/{claimRequest}/seen` | Mark a request as seen (clears red-dot indicator) |
| POST | `/claims/{claimRequest}/telegram-link` | A one-time link into the Bronjoy business bot that connects the applicant's Telegram, so claim updates reach them there and they can send documents straight ... |
| POST | `/payment/click/callback` | — |
| POST | `/org/clients/batch-update` | Batch update clients |
| POST | `/org/clients/batch-destroy` | Batch delete clients |
| GET | `/org/clients` | List the organization's clients (paginated), with visit counts and last/next visit |
| POST | `/org/clients` | Create a client |

…and 253 more operations. The page lists the first 250; the full set of 313 is in the OpenAPI linked below.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/bronjoy-com/openapi/_original/bronjoy-com-api-spec-openapi.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-organization-profile-resource-schema.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-appointment-resource-schema.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-create-organization-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-organization-resource-schema.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-subscription-resource-schema.json
- **JSONSchema** — https://artifacts.apis.io/bronjoy-com/json-schema/bronjoy-com-update-organization-profile-request-schema.json

## Other Bronjoy APIs (1)

- [Bronjoy API](https://apis.io/apis/bronjoy-com/bronjoy-api/)

---

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