Admin Resources

List resources with occupancy and opening-hours filters, read bookable vs view-only counts, and bulk-create child resources. For general request conventions, see JSON:API Conventions. For timeslots on a resource, see Admin Timeslot Management.

Prerequisites

A valid Bearer token with admin access — see Authentication
Organization context (?o={organization_id})

List resources

GET /api/v1/resources?o={org_id}

The same filter keys work on the public related list GET /api/v1/organizations/{organization_slug}/resources.

Occupancy and opening hours (“today”)

today is the current calendar day in the active organization’s timezone (UTC if there is no organization context). Passing false is a no-op: the filter is not applied.

Filter	Effect when `true`
`filter[booked_today]`	Only resources that have at least one accepted or requested booking whose period overlaps today. Canceled bookings are ignored.
`filter[active_today]`	Only resources that have a non-canceled timeslot overlapping today, or a weekly schedule for today’s weekday in a schedule group that is active today (`available_from` / `available_to`).

GET /api/v1/resources?o={org_id}&filter[booked_today]=true
GET /api/v1/resources?o={org_id}&filter[active_today]=true
GET /api/v1/organizations/{organization_slug}/resources?filter[booked_today]=true&filter[active_today]=true

You can combine both filters. A resource must then be booked today and have opening hours or a timeslot today.

These filters restrict the resource collection. They do not return the bookings or timeslots themselves. Use Booking Calendars or Availability & Booking Search for slot-level data. They are valid on HTTP resource index requests but are excluded from MCP tool schemas.

Bookable vs view-only counts

The admin resource overview uses a dedicated JSON endpoint (not a JSON:API resource):

GET /api/v1/resources/status-counts?o={org_id}

Response fields:

Field	Meaning
`bookable_resource_count`	Top-level resources with no children and bookings enabled
`bookable_child_resource_count`	Children of bookable parents that themselves have bookings enabled
`view_only_resource_count`	Top-level resources with no children and bookings disabled
`view_only_child_resource_count`	Children of view-only parents that themselves have bookings disabled
`total_resource_count`	Bookable + view-only top-level resources
`total_child_resource_count`	Bookable + view-only children
`min_resource_count`	Organization minimum resource usage
`min_child_resource_count`	Organization minimum child-resource usage

The same filter query object as GET /api/v1/resources is applied to the base query before the counts are split. This is distinct from GET /api/v1/resources/counts, which returns a view-uuid map for admin list tabs.

Create child resources

POST /api/v1/resources/{resource_id}/children?o={org_id}

{
  "child_resources": [
    { "name": "Desk 1" },
    { "name": "Desk 2" }
  ]
}

Field	Type	Required	Description
`child_resources`	array	Yes	At least one child. Each item needs `name`.

A successful response is HTTP 200 with a JSON:API collection of the resources that were just created (type: resources). Use those records for follow-up assignment (maps, services, properties) instead of re-listing the parent. The parent is marked as having children. If the organization cannot exceed its child-resource quota, the request fails with HTTP 400 and sales_quota_exceeded.

Common errors

Error	Cause	Solution
`400` — `sales_quota_exceeded`	Creating the children would exceed `min_child_resource_usage`	Remove children from the payload, or raise the organization’s child-resource quota
`403`	Missing create permission on resources	Use a role that can create resources
`422`	`child_resources` missing or a child has no `name`	Send a non-empty array of objects with `name`

​Prerequisites

​List resources

​Occupancy and opening hours (“today”)

​Bookable vs view-only counts

​Create child resources

​Common errors

Prerequisites

List resources

Occupancy and opening hours (“today”)

Bookable vs view-only counts

Create child resources

Common errors