Set your scoring profile

What it does: Replaces your scoring profile. The body is validated against the ranges GET reports before anything is stored; an out-of-range weight, an unknown knob, a fail that cannot be softened or an autoThreshold below 0.90 is refused with 400 and the message names the field. Unknown fields are 400 too.

Takes effect on new jobs only. Mappings already stored keep the score they were stored with. To re-score a hotel, purge its matches (DELETE /rooms/match/async/matches/{hotelId}) and submit it again. Preview a candidate first with POST /rooms/match/async/scoring-profile/preview.

Each change gets a new version that is never reused; score.profile on results (for example c368927/v3) names the exact policy that produced the number.

Available to accounts with their own isolated room-mapping cache; others receive 409. Details: Implementation Workflow (doc page: implementation-workflow).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

A full replacement of the profile. Every field is optional; a weight left out takes its default, an empty softened list softens nothing, an omitted autoThreshold is 0.90. Unknown fields are rejected (400), so a typo cannot silently reset a knob.

weights
object

Deduction per knob key (view, bedrooms, outdoor, tier_lower, bed, tier, restriction, minor, inferred), each within the range GET reports.

softened
array of strings

Fails that become a deduction instead of rejecting the mapping

softened
Allowed:
number

Lowest score that is still auto; 0.90 to 1.00

Responses

401

Unauthorized

413

Request body exceeds 1 MiB

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json