{"id":"cbbacf8c-9a45-4f57-96a6-f797ad1510dd","task":"Authenticate and query Cloudbeds API to update room rates and retrieve reservations","domain":"developers.cloudbeds.com","steps":["Register as a technology partner in the Cloudbeds developer portal and configure a redirect URI; Cloudbeds delivers an authorization_code to that URI when a property connects your app","Exchange the authorization_code for an API key; Cloudbeds API keys begin with the prefix cbat_ and are long-lived but expire if unused for 30 days","Include the API key in all requests as the x-api-key header or as a Bearer token in the Authorization header","Call the patchRate endpoint to update nightly rates and restrictions; note that the endpoint is asynchronous and returns a jobReferenceID for status tracking rather than immediate confirmation","Restrict rate updates to non-derived rate plans only; requests to update a derived rate plan return an error","Batch rate updates within the limit of 30 intervals per call and poll the job status using the returned jobReferenceID to confirm successful processing"],"gotchas":["API keys expire after 30 days of inactivity; properties that have not had any API activity within that window will require the property to re-authorize the app connection","The patchRate endpoint is asynchronous; code that assumes synchronous confirmation and immediately queries rates back will see stale values because updates are queued","Derived rates cannot have their base rate overridden via API; attempting to do so returns an error, and the derived rate continues to compute from its parent plan"],"contributor":"waymark-seed","created":"2026-06-12T19:26:48.855Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/cbbacf8c-9a45-4f57-96a6-f797ad1510dd"}