GET
/
v1
/
teams
/
{teamId}
/
scheduling-slots
/
next
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.schedulingSlots.getNextSchedulingSlots({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  query: {},
})
{
  "slots": [
    {
      "startsAt": "<string>",
      "hour": 123,
      "minute": 123,
      "label": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Query Parameters

​
socialAccountId
string

Connected social account id (UUID). When provided, the preview is occupancy-aware for that account; omit for a purely time-based preview.

​
count
string

How many upcoming slot instants to return, 1-20 (default 1). Values outside the range are clamped.

​
timezone
string

IANA timezone override used only when the team has no stored timezone; validated against the runtime's supported list (400 on an unsupported name).

Example:

"Europe/London"

Response

Success

​
slots
object[]
required