/v1/unit-groups/{unit_group_id}/ratesAuthentication
Bearer API key or Facily session, subject to permissions and facility scope.
Authentication and scopeRequest example
Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.
curl --request PATCH \
--url 'https://api.staging.facily.ai/v1/unit-groups/<UNIT_GROUP_ID>/rates' \
--header "Authorization: Bearer $FACILY_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"max_rate": 0,
"min_rate": 0,
"standard_rate": 0,
"web_rate": 0
}'Parameters
unit_group_idpath · stringrequiredFormat: uuid
Request body
application/json · Required
max_ratenumber | string | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show max_rate schema
number | string | nullVariant 1: number
numberVariant 2: string
stringVariant 3: null
nullmin_ratenumber | string | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show min_rate schema
number | string | nullVariant 1: number
numberVariant 2: string
stringVariant 3: null
nullstandard_ratenumber | string | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show standard_rate schema
number | string | nullVariant 1: number
numberVariant 2: string
stringVariant 3: null
nullweb_ratenumber | string | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show web_rate schema
number | string | nullVariant 1: number
numberVariant 2: string
stringVariant 3: null
nullResponses
Expand a status to inspect its schema. Generated examples show structure and synthetic values.
200Successful Response
{
"data": {
"created_at": "2026-10-29T12:00:00Z",
"facility_id": "00000000-0000-4000-8000-000000000001",
"id": "00000000-0000-4000-8000-000000000001",
"name": "string",
"updated_at": "2026-10-29T12:00:00Z",
"code": "string",
"description": "string",
"effective_standard_rate": "<VALUE_MATCHING_PATTERN>",
"effective_web_rate": "<VALUE_MATCHING_PATTERN>",
"feature_ids": [
"00000000-0000-4000-8000-000000000001"
],
"floor": 0,
"managed": false
},
"meta": {
"request_id": "string"
}
}application/json
dataapi__unit_groups__schemas__UnitGroupResponserequiredShow data schema
codestring | nullShort operator-assigned code for the group.
Show code schema
string | nullShort operator-assigned code for the group.
Variant 1: string
stringVariant 2: null
nullcreated_atstringrequiredWhen the group was created.
Format: date-time
descriptionstring | nullLonger description of what the group covers.
Show description schema
string | nullLonger description of what the group covers.
Variant 1: string
stringVariant 2: null
nulleffective_standard_ratestring | nullThe street rate a unit of this group quotes when it has no rate of its own.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_standard_rate schema
string | nullThe street rate a unit of this group quotes when it has no rate of its own.
Variant 1: string
stringVariant 2: null
nulleffective_web_ratestring | nullThe online rate a unit of this group quotes when it has no rate of its own.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_web_rate schema
string | nullThe online rate a unit of this group quotes when it has no rate of its own.
Variant 1: string
stringVariant 2: null
nullfacility_idstringrequiredThe facility this group belongs to.
Format: uuid
feature_idsstring[]The group's characteristics.
Show feature_ids schema
stringfloorinteger | nullFloor the group's units are on, when it has one.
Show floor schema
integer | nullFloor the group's units are on, when it has one.
Variant 1: integer
integerVariant 2: null
nullidstringrequiredUnique identifier for this unit group.
Format: uuid
managedbooleanTrue when pricing rules set the effective street rate.
Default: false
managed_ratestring | nullStreet rate set by pricing rules; null when none applies.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show managed_rate schema
string | nullStreet rate set by pricing rules; null when none applies.
Variant 1: string
stringVariant 2: null
nullmanaged_web_discountstring | nullPercentage points pricing rules add to the online discount; null when none applies.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show managed_web_discount schema
string | nullPercentage points pricing rules add to the online discount; null when none applies.
Variant 1: string
stringVariant 2: null
nullmax_ratestring | nullCeiling: no pricing rule moves the street rate above it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show max_rate schema
string | nullCeiling: no pricing rule moves the street rate above it.
Variant 1: string
stringVariant 2: null
nullmin_ratestring | nullFloor: no pricing rule moves the street rate below it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show min_rate schema
string | nullFloor: no pricing rule moves the street rate below it.
Variant 1: string
stringVariant 2: null
nullnamestringrequiredDisplay name of the group.
rates_changed_atstring | nullWhen the group's effective street or online rate last changed.
Format: date-time
Show rates_changed_at schema
string | nullWhen the group's effective street or online rate last changed.
Variant 1: string
stringVariant 2: null
nullstandard_ratestring | nullBase street rate the operator set; units with no rate of their own start from it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show standard_rate schema
string | nullBase street rate the operator set; units with no rate of their own start from it.
Variant 1: string
stringVariant 2: null
nullupdated_atstringrequiredWhen the group was last modified.
Format: date-time
web_managedbooleanTrue when a pricing rule adjusts the effective online rate.
Default: false
web_ratestring | nullBase online rate the operator set, optional.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show web_rate schema
string | nullBase online rate the operator set, optional.
Variant 1: string
stringVariant 2: null
nullmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired400Validation error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired401Unauthenticated
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired403Permission denied
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired404Not found
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired409Business logic error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired503Temporary failure
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired