coss.comdocs

List who a booking could go to

GET
/v1/scheduling/bookings/{id}/reassign_candidates

The environment's other active hosts: members of the event type first, in the order a pool would pick them, each saying whether they're free and why not. Things can change before you ask: reassigning decides again.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A secret API key from the dashboard: coss_live_… for production environments, coss_test_… for sandbox environments.

Path Parameters

id*string

The booking's id.

Query Parameters

from_host?string

The host who'd leave, when it could be several.

Header Parameters

Coss-Version?"2026-10-10"

The API version (a date) to use for this request. Defaults to your organization's version, pinned to the latest one when it first used the API and upgraded from the dashboard. The SDK always sends the version it was built for.

Value in"2026-10-10"

Response Body

The candidates.

application/json
  1. response
object*"list"
Value in"list"
data*array<>
has_more*boolean
import { Coss } from "coss";const coss = new Coss({  apiKey: process.env.COSS_API_KEY,  baseUrl: "https://api.coss.com",});const { data, error } = await coss.scheduling.bookings.reassignCandidates("book_01kd2m9a0b1c2d3e4f5g6h7j8m");
{  "object": "list",  "data": [    {      "object": "scheduling.reassign_candidate",      "host": "host_01kd2m9a0b1c2d3e4f5g6h7j8m",      "uid": "doctor_518",      "name": "Dr. Priya Raman",      "member": true,      "available": true,      "reason": null,      "reasons": [],      "load": 4,      "rank": 1,      "meeting_provider_missing": false    }  ],  "has_more": false}