A resource and quantity suggested by a room setup.
| Property | Value |
|---|---|
| Product | Calendar (pco.calendar, API version 2026-06-22) |
| Resource type | ResourceSuggestion |
| TypeScript | Calendar.ResourceSuggestion, attributes Calendar.ResourceSuggestionAttributes, schema Calendar.ResourceSuggestionSchema |
| Planning Center path | /calendar/v2/room_setups/{room_setup_id}/resource_suggestions |
| Planning Center docs | ResourceSuggestion |
How to reach it
| Client path | Returns | Filters | Create |
|---|---|---|---|
pco.calendar.room_setups.id(roomSetupId).resource_suggestions |
Collection | No |
From a collection, .id(resourceSuggestionId) addresses one ResourceSuggestion: pco.calendar.room_setups.id(roomSetupId).resource_suggestions.id(resourceSuggestionId). Collections support where, include, order, and pagination; single resources have get().
Attributes
On Calendar.ResourceSuggestionAttributes. Every resource also has id and type ('ResourceSuggestion') next to its attributes.
| Name | Type | Description |
|---|---|---|
created_at |
string | null |
UTC time at which the suggestion was created |
quantity |
number | null |
How many resources should be requested |
updated_at |
string | null |
UTC time at which the suggestion was updated |
Relationships and includes
Side-load with include() (or get({ include })) and read with related(resource, name): resource.
Querying
No documented where fields.
No documented order fields.
Edges
Follow these from one ResourceSuggestion, ref = pco.calendar.room_setups.id(roomSetupId).resource_suggestions.id(resourceSuggestionId):
| Edge | Leads to | Returns | Filters | Create |
|---|---|---|---|---|
ref.resource |
Resource | Collection | No |
Writing
| Property | Value |
|---|---|
| Create | No |
| Update | No |
| Delete | No |
Example
import type { Calendar } from '@mackenly/planningcenterkit';
const roomSetupId = '1'; // RoomSetup id
const page = await pco.calendar.room_setups.id(roomSetupId).resource_suggestions.perPage(25).list();
const items: Calendar.ResourceSuggestion[] = page.data;