{"uid":"cap_txwoYLu2Va--OTohhjtY4","slug":"halowerk-occupancy-optimizer-3c6908b9","name":"Halowerk Occupancy Optimizer","description":"Sorts groups by size, then assigns each to the available room that has all required features and minimizes unused capacity, hourly cost and room identifier in that order. This fast heuristic is not guaranteed globally optimal and does not handle time overlap, accessibility beyond supplied features, movement, privacy or building-code constraints.","url":"https://prop.halowerk.com/v1/occupancy-optimize","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rooms":{"type":"array","items":{"type":"object","required":["room_id","capacity","hourly_cost","features"],"properties":{"room_id":{"type":"string","maxLength":128,"minLength":1},"capacity":{"type":"integer","maximum":1000000,"minimum":1},"features":{"type":"array","items":{"type":"string","maxLength":128,"minLength":1},"maxItems":1000,"uniqueItems":true},"hourly_cost":{"type":"number","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":10000,"minItems":1},"groups":{"type":"array","items":{"type":"object","required":["group_id","people","required_features"],"properties":{"people":{"type":"integer","maximum":1000000,"minimum":1},"group_id":{"type":"string","maxLength":128,"minLength":1},"required_features":{"type":"array","items":{"type":"string","maxLength":128,"minLength":1},"maxItems":1000,"uniqueItems":true}},"additionalProperties":false},"maxItems":10000,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Zbn8OhTNcX_arTCJCqLmT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Assigns groups of people to rooms by matching required features and minimizing unused capacity, hourly cost, and room ID in that order","exampleAgentPrompt":"We have 5 meeting groups: Sales (12 people, needs projector and whiteboard), HR (4 people, needs privacy screen), Engineering (8 people, needs video conferencing), Design (6 people, needs whiteboard), and Exec (3 people, needs projector and privacy screen). Our rooms are: Room A (capacity 15, $20/hr, has projector, whiteboard, video conferencing), Room B (capacity 10, $12/hr, has whiteboard, privacy screen), Room C (capacity 5, $8/hr, has projector, privacy screen), Room D (capacity 8, $10/hr, has video conferencing, whiteboard). Can you find the optimal room assignment that covers all required features and minimizes wasted capacity and cost?","exampleUseCases":[{"title":"Conference room assignment for all-hands breakouts","prompt":"We're running 4 breakout sessions today: Marketing (10 people, needs projector), Dev (18 people, needs video conferencing and whiteboard), Finance (6 people, needs privacy screen), and Leadership (3 people, needs projector and privacy screen). Our available rooms are: Boardroom (20 seats, $30/hr, projector, privacy screen), Main Hall (25 seats, $40/hr, projector, whiteboard, video conferencing), Small Suite (8 seats, $15/hr, privacy screen, projector), and Team Room (20 seats, $25/hr, video conferencing, whiteboard). Assign each group to the best-fit room minimizing unused capacity and cost."},{"title":"Co-working space daily group allocation","prompt":"I manage a co-working space and today I have 3 groups needing rooms: a podcast crew (5 people, needs soundproofing and microphone setup), a yoga class (15 people, needs open floor and mirror), and a coding bootcamp (20 people, needs whiteboards and fast wifi). My rooms are: Studio A (6 capacity, $10/hr, soundproofing, microphone setup), Studio B (22 capacity, $20/hr, open floor, mirror, whiteboard), Studio C (20 capacity, $18/hr, whiteboards, fast wifi). What's the optimal assignment?"},{"title":"Hotel banquet room allocation for events","prompt":"We have 3 event groups this weekend: a wedding reception (80 people, needs stage and dance floor), a corporate dinner (40 people, needs projector and PA system), and a workshop (25 people, needs whiteboard and breakout tables). Available rooms: Grand Ballroom (100 capacity, $200/hr, stage, dance floor, PA system), Conference Suite (50 capacity, $80/hr, projector, PA system, whiteboard), Seminar Room (30 capacity, $50/hr, whiteboard, breakout tables). Assign rooms to minimize wasted space and cost."}],"resultDescription":"Returns an assignment of each group to a specific room, selected so that the room has all the group's required features and the chosen room minimizes unused capacity (seats above group size), then hourly cost, then room ID. Groups are sorted by size before assignment, applying a greedy heuristic. The response indicates which room each group is placed in, along with residual capacity and cost details.","failureModes":["No feasible assignment exists if a group's required features cannot be satisfied by any available room","Groups larger than all available rooms cannot be assigned","Invalid input (missing required fields, non-positive capacity or people count) returns a validation error","Very large inputs (up to 10,000 rooms/groups) may still return quickly but assignment is heuristic and not globally optimal","Ties in capacity and cost are broken by room_id lexicographic order, which may not match caller expectations"],"whenToPreferThis":"Use this endpoint when you need a fast, automated assignment of multiple groups to rooms based on feature requirements and want to minimize wasted capacity and cost without requiring global optimality. It is well-suited for event planning, facility management, co-working spaces, and corporate room booking at scale. Prefer this over manual assignment or more complex scheduling solvers when time-overlap constraints do not apply and a greedy heuristic is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:35.284Z","isFirstParty":false}