Skip to content
API reference / Locations
PUT /api/v1/locations/{id}/location-groups

Token needs the update ability. About tokens

Replaces the set of location groups a Location belongs to. location_group_ids is required (an empty array is rejected). Requires the update ability.

Path parameters

  • id string (uuid) required
    Resource UUID.

Request body application/json

  • location_group_ids array of string required

Responses

    • data Location
      • id string (uuid)
      • external_id string nullable
      • name string
      • address string nullable
      • city string nullable
      • region string nullable
      • postal_code string nullable
      • country string nullable
      • timezone string nullable
        IANA zone the location's business day runs on. Null until resolved; the tenant timezone applies meanwhile.
      • timezone_source string nullable
        Where the timezone came from. user was chosen by a person and is never overwritten by the nightly resolver; the others were detected automatically.
        user pos google state
      • is_private boolean
      • is_corporate boolean
      • is_active boolean
        True only for an active location; false for both pending and deactivated ones — see activation_status.
      • activation_status string
        pending was never activated; active collects metrics and ranks on leaderboards; deactivated was taken out of service and stays in historical network totals.
        pending active deactivated
      • deactivated_at string (date-time) nullable
        When the location was taken out of service. Null unless activation_status is deactivated.
      • is_deletable boolean
        Whether DELETE will succeed: true for a pending location, a deactivated one that never loaded any sales, labor or custom-metric data, or a deactivated one whose daily history has aged out of reporting retention.
      • deletable_on string (date) nullable
        For a deactivated location still inside retention, the date it becomes deletable (always a Jan 1). Null when it is already deletable, active, or pending.
      • district_id string (uuid) nullable
      • district_id_2 string (uuid) nullable
      • location_category_id string (uuid) nullable
      • created_at string (date-time) nullable
      • updated_at string (date-time) nullable
      • datasource_settings object
        POS identifiers for the location. Credentials are never returned: each one is reported only as {key}_set, true when a value is stored.
        • qu object
          • location_id integer nullable
        • brink object
          • api_key_set boolean
      • district object nullable
        Present only when included.
        • id string (uuid)
        • name string
        • external_id string nullable
        • district_group_id string (uuid) nullable
        • created_at string (date-time) nullable
        • updated_at string (date-time) nullable
        • districtGroup object nullable
          Present only when included.
          • id string (uuid)
          • name string
          • index integer
          • created_at string (date-time) nullable
          • updated_at string (date-time) nullable
      • district2 object nullable
        Present only when included.
        • id string (uuid)
        • name string
        • external_id string nullable
        • district_group_id string (uuid) nullable
        • created_at string (date-time) nullable
        • updated_at string (date-time) nullable
        • districtGroup object nullable
          Present only when included.
          • id string (uuid)
          • name string
          • index integer
          • created_at string (date-time) nullable
          • updated_at string (date-time) nullable
      • locationCategory object nullable
        Present only when included.
        • id string (uuid)
        • name string
        • external_id string nullable
        • location_category_group_id string (uuid) nullable
        • sort_order integer nullable
        • created_at string (date-time) nullable
        • updated_at string (date-time) nullable
        • locationCategoryGroup object nullable
          Present only when included.
          • id string (uuid)
          • name string
          • index integer
          • created_at string (date-time) nullable
          • updated_at string (date-time) nullable
      • locationGroups array of LocationGroup
        Present only when included (and on the Sync Location Groups response).
        • id string (uuid)
        • name string
        • external_id string nullable
        • created_at string (date-time) nullable
        • updated_at string (date-time) nullable
        • locations array of Location
          Present only when included.
          • id string (uuid)
          • external_id string nullable
          • name string
          • address string nullable
          • city string nullable
          • region string nullable
          • postal_code string nullable
          • country string nullable
          • timezone string nullable
            IANA zone the location's business day runs on. Null until resolved; the tenant timezone applies meanwhile.
          • timezone_source string nullable
            Where the timezone came from. user was chosen by a person and is never overwritten by the nightly resolver; the others were detected automatically.
            user pos google state
          • is_private boolean
          • is_corporate boolean
          • is_active boolean
            True only for an active location; false for both pending and deactivated ones — see activation_status.
          • activation_status string
            pending was never activated; active collects metrics and ranks on leaderboards; deactivated was taken out of service and stays in historical network totals.
            pending active deactivated
          • deactivated_at string (date-time) nullable
            When the location was taken out of service. Null unless activation_status is deactivated.
          • is_deletable boolean
            Whether DELETE will succeed: true for a pending location, a deactivated one that never loaded any sales, labor or custom-metric data, or a deactivated one whose daily history has aged out of reporting retention.
          • deletable_on string (date) nullable
            For a deactivated location still inside retention, the date it becomes deletable (always a Jan 1). Null when it is already deletable, active, or pending.
          • district_id string (uuid) nullable
          • district_id_2 string (uuid) nullable
          • location_category_id string (uuid) nullable
          • created_at string (date-time) nullable
          • updated_at string (date-time) nullable
          • datasource_settings object
            POS identifiers for the location. Credentials are never returned: each one is reported only as {key}_set, true when a value is stored.
          • district object nullable
            Present only when included.
          • district2 object nullable
            Present only when included.
          • locationCategory object nullable
            Present only when included.
          • locationGroups array of any
            Present only when included (and on the Sync Location Groups response).
    • message string
    • message string
    • message string
    • message string
    • errors object
curl -X PUT "https://app.franchisesee.com/api/v1/locations/9d3f6b2e-5a41-4c7e-9a0b-2f1c8e7d4a63/location-groups" \
  -H "Authorization: Bearer $FRANCHISESEE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "location_group_ids": [
        "019be24b-8fb3-7065-bcda-b3a26afdda1f",
        "019be24b-8fb2-718a-a686-cd8eb8834625"
    ]
}'
Response
{
    "data": {
        "id": "9b1c8f3e-7a2d-4c5b-8e1a-2f3d4c5b6a7e",
        "external_id": "STR-1042",
        "name": "Downtown Austin",
        "address": "401 Congress Ave",
        "city": "Austin",
        "region": "TX",
        "postal_code": "78701",
        "country": "US",
        "timezone": "America/Chicago",
        "timezone_source": "pos",
        "is_private": false,
        "is_corporate": false,
        "is_active": true,
        "activation_status": "active",
        "deactivated_at": null,
        "is_deletable": false,
        "deletable_on": null,
        "district_id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9",
        "district_id_2": "c7e9a2d4-1b3f-4e8a-9c6d-5f2e8b1a7d30",
        "location_category_id": "5d8e2f1a-6c4b-4a9e-8f3d-2b7c1e9a4d60",
        "created_at": "2025-03-14T15:22:08.000000Z",
        "updated_at": "2026-10-02T09:41:55.000000Z",
        "datasource_settings": {
            "qu": {
                "location_id": 12345
            },
            "brink": {
                "api_key_set": true
            }
        },
        "district": {
            "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9",
            "name": "Central Texas",
            "external_id": "CTX",
            "district_group_id": "e1a4c8b2-7d3f-4b6e-9a2c-8f5d1e3b7a90",
            "created_at": "2025-03-14T15:22:08.000000Z",
            "updated_at": "2026-10-02T09:41:55.000000Z",
            "districtGroup": {
                "id": "e1a4c8b2-7d3f-4b6e-9a2c-8f5d1e3b7a90",
                "name": "Region",
                "index": 1,
                "created_at": "2025-03-14T15:22:08.000000Z",
                "updated_at": "2026-10-02T09:41:55.000000Z"
            }
        },
        "district2": {
            "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9",
            "name": "Central Texas",
            "external_id": "CTX",
            "district_group_id": "e1a4c8b2-7d3f-4b6e-9a2c-8f5d1e3b7a90",
            "created_at": "2025-03-14T15:22:08.000000Z",
            "updated_at": "2026-10-02T09:41:55.000000Z",
            "districtGroup": {
                "id": "e1a4c8b2-7d3f-4b6e-9a2c-8f5d1e3b7a90",
                "name": "Region",
                "index": 1,
                "created_at": "2025-03-14T15:22:08.000000Z",
                "updated_at": "2026-10-02T09:41:55.000000Z"
            }
        },
        "locationCategory": {
            "id": "5d8e2f1a-6c4b-4a9e-8f3d-2b7c1e9a4d60",
            "name": "Inline",
            "external_id": "INLINE",
            "location_category_group_id": "f2b6d8a1-4c3e-4e7b-a5d9-1c8e3f6b2a40",
            "sort_order": 1,
            "created_at": "2025-03-14T15:22:08.000000Z",
            "updated_at": "2026-10-02T09:41:55.000000Z",
            "locationCategoryGroup": {
                "id": "e1a4c8b2-7d3f-4b6e-9a2c-8f5d1e3b7a90",
                "name": "Region",
                "index": 1,
                "created_at": "2025-03-14T15:22:08.000000Z",
                "updated_at": "2026-10-02T09:41:55.000000Z"
            }
        },
        "locationGroups": [
            {
                "id": "a3c5e7f9-2b4d-4f6a-8c1e-3d5f7a9b1c20",
                "name": "Austin Metro",
                "external_id": "AUS-METRO",
                "created_at": "2025-03-14T15:22:08.000000Z",
                "updated_at": "2026-10-02T09:41:55.000000Z",
                "locations": [
                    {
                        "id": "9b1c8f3e-7a2d-4c5b-8e1a-2f3d4c5b6a7e",
                        "external_id": "STR-1042",
                        "name": "Downtown Austin",
                        "address": "401 Congress Ave",
                        "city": "Austin",
                        "region": "TX",
                        "postal_code": "78701",
                        "country": "US",
                        "timezone": "America/Chicago",
                        "timezone_source": "pos",
                        "is_private": false,
                        "is_corporate": false,
                        "is_active": true,
                        "activation_status": "active",
                        "deactivated_at": null,
                        "is_deletable": false,
                        "deletable_on": null,
                        "district_id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9",
                        "district_id_2": "c7e9a2d4-1b3f-4e8a-9c6d-5f2e8b1a7d30",
                        "location_category_id": "5d8e2f1a-6c4b-4a9e-8f3d-2b7c1e9a4d60",
                        "created_at": "2025-03-14T15:22:08.000000Z",
                        "updated_at": "2026-10-02T09:41:55.000000Z",
                        "datasource_settings": {
                            "qu": {
                                "location_id": 12345
                            },
                            "brink": {
                                "api_key_set": true
                            }
                        },
                        "district": {},
                        "district2": {},
                        "locationCategory": {},
                        "locationGroups": []
                    }
                ]
            }
        ]
    }
}