{
    "info": {
        "_postman_id": "28805b27-0c48-4973-875a-ddb51d137929",
        "name": "Guper · Register",
        "description": "Guper Register API reference. Generated from the documentation portal.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "item": [
        {
            "name": "Audience list",
            "item": [
                {
                    "name": "List",
                    "item": [
                        {
                            "name": "Create audience list",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "audience-list"
                                    ]
                                },
                                "description": "Creates a new audience list (`register.list` row) — the segment of customers\nused by campaigns, messaging, and broadcast endpoints. Only `name` is required;\neverything else describes how the list is populated:\n\n- `listType: manual` — members are added one-by-one via the `audience-list/{id}/person` endpoints.\n- `listType: query` — `parameters` holds an Audience Query (QON) that resolves dynamically.\n- `listType: import` — used by the file-import flow; consumers should set the import fields via the dedicated upload endpoint instead of crafting them here.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"VIP customers — May campaign\",\n    \"status\": \"new\",\n    \"listType\": \"manual\",\n    \"parameters\": {},\n    \"contentHash\": \"<contentHash>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Audience list created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "audience-list"
                                            ]
                                        },
                                        "description": "Creates a new audience list (`register.list` row) — the segment of customers\nused by campaigns, messaging, and broadcast endpoints. Only `name` is required;\neverything else describes how the list is populated:\n\n- `listType: manual` — members are added one-by-one via the `audience-list/{id}/person` endpoints.\n- `listType: query` — `parameters` holds an Audience Query (QON) that resolves dynamically.\n- `listType: import` — used by the file-import flow; consumers should set the import fields via the dedicated upload endpoint instead of crafting them here.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"VIP customers — May campaign\",\n    \"status\": \"new\",\n    \"listType\": \"manual\",\n    \"parameters\": {},\n    \"contentHash\": \"<contentHash>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 42,\n    \"name\": \"VIP customers — May campaign\",\n    \"status\": \"new\",\n    \"listType\": \"manual\",\n    \"parameters\": null,\n    \"contentHash\": null,\n    \"importStep\": null,\n    \"importTotalRecords\": null,\n    \"importStatsFound\": null,\n    \"importStatsNotFound\": null,\n    \"importStatsInvalid\": null\n}"
                                }
                            ]
                        },
                        {
                            "name": "Fetch list",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "audience-list"
                                    ]
                                },
                                "description": "Returns the audience lists belonging to the organization."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "audience-list"
                                            ]
                                        },
                                        "description": "Returns the audience lists belonging to the organization."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Remove audience list",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "audience-list"
                                    ]
                                },
                                "description": "Removes an audience list (soft-delete via `Tools\\Data\\Delete`). The ID goes in\nthe request body, not in the URL.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 42\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Audience list removed.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "audience-list"
                                            ]
                                        },
                                        "description": "Removes an audience list (soft-delete via `Tools\\Data\\Delete`). The ID goes in\nthe request body, not in the URL.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 42\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update audience list",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "audience-list"
                                    ]
                                },
                                "description": "Updates an existing audience list. Only `id` is required; any other field\npresent in the body is updated, anything omitted is left untouched.\n\n> Avoid mutating the `import*` fields manually — they are owned by the\n> import cron pipeline.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 42,\n    \"name\": \"VIP customers — May campaign\",\n    \"status\": \"processed\",\n    \"listType\": \"manual\",\n    \"parameters\": {},\n    \"contentHash\": \"<contentHash>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Audience list updated.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/audience-list",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "audience-list"
                                            ]
                                        },
                                        "description": "Updates an existing audience list. Only `id` is required; any other field\npresent in the body is updated, anything omitted is left untouched.\n\n> Avoid mutating the `import*` fields manually — they are owned by the\n> import cron pipeline.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 42,\n    \"name\": \"VIP customers — May campaign\",\n    \"status\": \"processed\",\n    \"listType\": \"manual\",\n    \"parameters\": {},\n    \"contentHash\": \"<contentHash>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Custom Fields",
            "item": [
                {
                    "name": "List custom fields",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "custom-field"
                            ]
                        },
                        "description": "Lists the organization's metadata keys (the *custom-field* catalog). Keys are\ncreated automatically the first time a value is written for them (via Data\nCapture or the `customer/{id}/metadata` endpoint) — this endpoint is mainly for\nbuilding pickers and management screens. `type` is a best-effort hint\n(`text` / `number` / `date`) inferred from the values seen; `label` is an\noptional friendly name set by an admin."
                    },
                    "response": [
                        {
                            "name": "Paginated list of custom-field definitions.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "custom-field"
                                    ]
                                },
                                "description": "Lists the organization's metadata keys (the *custom-field* catalog). Keys are\ncreated automatically the first time a value is written for them (via Data\nCapture or the `customer/{id}/metadata` endpoint) — this endpoint is mainly for\nbuilding pickers and management screens. `type` is a best-effort hint\n(`text` / `number` / `date`) inferred from the values seen; `label` is an\noptional friendly name set by an admin."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        { \"id\": 1, \"metaKey\": \"kid_birthday\", \"label\": \"Kid's birthday\", \"type\": \"date\" },\n        { \"id\": 2, \"metaKey\": \"shirt_size\",   \"label\": null,             \"type\": \"text\" }\n    ],\n    \"page\": 1,\n    \"pages\": 1\n}"
                        }
                    ]
                },
                {
                    "name": "Delete custom field",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "custom-field"
                            ]
                        },
                        "description": "Removes a metadata key from the organization **and deletes all of its values**\nacross every person (`person_custom_field`). Destructive and irreversible —\nconfirm before calling. Returns how many person values were removed.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"metaKey\": \"shirt_size\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Key and its values removed.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "custom-field"
                                    ]
                                },
                                "description": "Removes a metadata key from the organization **and deletes all of its values**\nacross every person (`person_custom_field`). Destructive and irreversible —\nconfirm before calling. Returns how many person values were removed.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"metaKey\": \"shirt_size\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"metaKey\": \"shirt_size\",\n    \"valuesRemoved\": 42\n}"
                        }
                    ]
                },
                {
                    "name": "Set custom field label",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "custom-field"
                            ]
                        },
                        "description": "Sets the friendly `label` of a metadata key. Only the label is editable — the\n`metaKey` itself is immutable (it is the storage key) and `type` is inferred.\nIf the key does not exist yet, no row is affected.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"metaKey\": \"shirt_size\",\n    \"label\": \"Shirt size\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "The updated key/label.",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/custom-field",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "custom-field"
                                    ]
                                },
                                "description": "Sets the friendly `label` of a metadata key. Only the label is editable — the\n`metaKey` itself is immutable (it is the storage key) and `type` is inferred.\nIf the key does not exist yet, no row is affected.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"metaKey\": \"shirt_size\",\n    \"label\": \"Shirt size\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"metaKey\": \"shirt_size\",\n    \"label\": \"Shirt size\"\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Customer",
            "item": [
                {
                    "name": "Create customer",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer"
                            ]
                        },
                        "description": "Creates a new customer (`isCustomer = 1` in `register.person`). The `name` field is\nrequired; at least one of `cellphone`, `email`, or `document` must also be supplied\nso the record can be matched later (see `matchPattern` on the organization). The\npayload goes through `Person\\Sanitize` — phone is normalized via `libphonenumber`,\nemail is lower-cased, document keeps only alphanumerics and is lower-cased.\n\nOn success, the freshly created person is returned with the default *Rookie* tag\nalready assigned and a history record (`Create person`) inserted.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\",\n    \"optin\": \"2026-05-03T10:00:00-03:00\",\n    \"privacyAccepted\": \"2026-05-03T10:00:00-03:00\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Customer created.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer"
                                    ]
                                },
                                "description": "Creates a new customer (`isCustomer = 1` in `register.person`). The `name` field is\nrequired; at least one of `cellphone`, `email`, or `document` must also be supplied\nso the record can be matched later (see `matchPattern` on the organization). The\npayload goes through `Person\\Sanitize` — phone is normalized via `libphonenumber`,\nemail is lower-cased, document keeps only alphanumerics and is lower-cased.\n\nOn success, the freshly created person is returned with the default *Rookie* tag\nalready assigned and a history record (`Create person`) inserted.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\",\n    \"optin\": \"2026-05-03T10:00:00-03:00\",\n    \"privacyAccepted\": \"2026-05-03T10:00:00-03:00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 683752,\n    \"mainId\": null,\n    \"entityType\": \"individual\",\n    \"name\": \"Tintin\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"document\": \"32165987\",\n    \"gender\": \"male\",\n    \"postalCode\": \"13450000\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"language\": \"pt_BR\",\n    \"createdAt\": \"2026-05-03T10:00:00-03:00\",\n    \"updatedAt\": \"2026-05-03T10:00:00-03:00\"\n}"
                        },
                        {
                            "name": "Insufficient data — none of `name`, `cellphone`, `email`, `document` were provided.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer"
                                    ]
                                },
                                "description": "Creates a new customer (`isCustomer = 1` in `register.person`). The `name` field is\nrequired; at least one of `cellphone`, `email`, or `document` must also be supplied\nso the record can be matched later (see `matchPattern` on the organization). The\npayload goes through `Person\\Sanitize` — phone is normalized via `libphonenumber`,\nemail is lower-cased, document keeps only alphanumerics and is lower-cased.\n\nOn success, the freshly created person is returned with the default *Rookie* tag\nalready assigned and a history record (`Create person`) inserted.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\",\n    \"optin\": \"2026-05-03T10:00:00-03:00\",\n    \"privacyAccepted\": \"2026-05-03T10:00:00-03:00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 412,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Feed",
                    "item": [
                        {
                            "name": "Commit items",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feed",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feed"
                                    ]
                                },
                                "description": "Acknowledges consumption of customer feed entries by sending the tokens back. Once acknowledged, those entries no longer appear in subsequent reads.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\r\n    \"tokens\": [\r\n        \"5BE6DABCFEC711EFAAC602B02E860C9523628\"\r\n    ]\r\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Acknowledged",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feed",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feed"
                                            ]
                                        },
                                        "description": "Acknowledges consumption of customer feed entries by sending the tokens back. Once acknowledged, those entries no longer appear in subsequent reads.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\r\n    \"tokens\": [\r\n        \"5BE6DABCFEC711EFAAC602B02E860C9523628\"\r\n    ]\r\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"acknowledged\": 2\n}"
                                }
                            ]
                        },
                        {
                            "name": "Retrieve items",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feed",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feed"
                                    ]
                                },
                                "description": "Retrieves pending entries from the customer feed (customers created, updated, tagged or otherwise modified since the last acknowledgement)."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feed",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feed"
                                            ]
                                        },
                                        "description": "Retrieves pending entries from the customer feed (customers created, updated, tagged or otherwise modified since the last acknowledgement)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    {\n        \"confirmToken\": \"2A0067C7FECB11EFAAC602B02E860C9532173\",\n        \"subscriber\": \"cloe-acme-TARQTDBN\",\n        \"module\": \"person\",\n        \"key\": 71918412,\n        \"confirmedAt\": null,\n        \"createdAt\": \"2025-03-11T16:50:00-03:00\"\n    },\n    {\n        \"confirmToken\": \"409FBC97FED111EFAAC602B02E860C9578560\",\n        \"subscriber\": \"cloe-acme-TARQTDBN\",\n        \"module\": \"person\",\n        \"key\": 71928432,\n        \"confirmedAt\": null,\n        \"createdAt\": \"2025-03-11T17:33:35-03:00\"\n    },\n    {\n        \"confirmToken\": \"65as4d6as85d49qd51q69we54q9w58de496sa\",\n        \"subscriber\": \"cloe-acme-TARQTDBN\",\n        \"module\": \"person\",\n        \"key\": 71896943,\n        \"confirmedAt\": null,\n        \"createdAt\": \"2025-03-11T14:41:14-03:00\"\n    },\n    {\n        \"confirmToken\": \"8374E01DFEC111EFAAC602B02E860C9555273\",\n        \"subscriber\": \"cloe-acme-TARQTDBN\",\n        \"module\": \"person\",\n        \"key\": 71906811,\n        \"confirmedAt\": null,\n        \"createdAt\": \"2025-03-11T15:40:55-03:00\"\n    }\n]"
                                },
                                {
                                    "name": "Empty",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feed",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feed"
                                            ]
                                        },
                                        "description": "Retrieves pending entries from the customer feed (customers created, updated, tagged or otherwise modified since the last acknowledgement)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Get Customer",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer",
                                "{{person}}"
                            ]
                        },
                        "description": "Returns a single customer by its identifier, enriched with all related data\navailable for that person: RFM metrics, attributes, active tags, referral,\nwatchlist, tier and membership.\n\nThe base fields are always present. The nested objects (`rfm`, `attributes`,\n`store`, `tags`, `referral`, `watchlist`, `tier`, `membership`, `lifecycle`,\n`metadata`) are included only when the customer has the corresponding records —\nwhen absent, the key is omitted from the response. `firstName`/`lastName` are\nderived from `name`.\n\n**`metadata`** is a flat `{ metaKey: value }` object of the person's custom\nfields (free key/value metadata). See the Custom Fields guide and the\n`customer/{id}/metadata` endpoints.\n\n**`lifecycle`** carries the customer's stage — `stage` is one of `lead`,\n`customer` or `churn`. When `stage` is `customer`, `churnAt` is the predicted\ndate the customer turns to churn if they don't buy again (it moves forward on\nevery purchase); when `stage` is `churn`, `churnedAt` is when they became\ninactive. The same stage is also present in `tags` as `Lead`/`Customer`/`Churn`\n(tags `5`/`6`/`7`). See the Customer Lifecycle guide."
                    },
                    "response": [
                        {
                            "name": "Successful Response",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{person}}"
                                    ]
                                },
                                "description": "Returns a single customer by its identifier, enriched with all related data\navailable for that person: RFM metrics, attributes, active tags, referral,\nwatchlist, tier and membership.\n\nThe base fields are always present. The nested objects (`rfm`, `attributes`,\n`store`, `tags`, `referral`, `watchlist`, `tier`, `membership`, `lifecycle`,\n`metadata`) are included only when the customer has the corresponding records —\nwhen absent, the key is omitted from the response. `firstName`/`lastName` are\nderived from `name`.\n\n**`metadata`** is a flat `{ metaKey: value }` object of the person's custom\nfields (free key/value metadata). See the Custom Fields guide and the\n`customer/{id}/metadata` endpoints.\n\n**`lifecycle`** carries the customer's stage — `stage` is one of `lead`,\n`customer` or `churn`. When `stage` is `customer`, `churnAt` is the predicted\ndate the customer turns to churn if they don't buy again (it moves forward on\nevery purchase); when `stage` is `churn`, `churnedAt` is when they became\ninactive. The same stage is also present in `tags` as `Lead`/`Customer`/`Churn`\n(tags `5`/`6`/`7`). See the Customer Lifecycle guide."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 4224868,\n    \"mainId\": null,\n    \"entityType\": null,\n    \"name\": \"ivone suerez\",\n    \"email\": \"freshcoolingscsa@gmail.com\",\n    \"countryCallingCode\": 52,\n    \"cellphone\": \"2224366229\",\n    \"document\": null,\n    \"gender\": \"female\",\n    \"postalCode\": \"72000\",\n    \"dateOfBirth\": \"1984-02-13T00:00:00-03:00\",\n    \"language\": null,\n    \"flags\": null,\n    \"matchWith\": null,\n    \"isHomologation\": 0,\n    \"validatedAt\": \"2026-05-28T23:19:11-03:00\",\n    \"pinType\": \"dynamic\",\n    \"pinExpiresAt\": \"2026-05-28T23:48:35-03:00\",\n    \"optin\": \"2026-05-28T23:18:34-03:00\",\n    \"privacyAccepted\": null,\n    \"createdAt\": \"2026-05-28T20:17:11-03:00\",\n    \"updatedAt\": \"2026-05-28T20:19:10-03:00\",\n    \"firstName\": \"Ivone\",\n    \"lastName\": \"Suerez\",\n    \"rfm\": {\n        \"firstPurchaseId\": 5578246,\n        \"lastPurchaseId\": 5578246,\n        \"firstPurchaseDate\": \"2026-05-28T20:20:26-03:00\",\n        \"lastPurchaseDate\": \"2026-05-28T20:20:26-03:00\",\n        \"averagePurchaseInterval\": 0,\n        \"totalPurchaseValue\": 481003,\n        \"totalPurchases\": 1,\n        \"daysWithoutPurchase\": 0,\n        \"lastRewardCardId\": 1801158,\n        \"lastRewardCardDate\": \"2026-05-28T23:20:26-03:00\"\n    },\n    \"attributes\": {\n        \"firstStore\": 12,\n        \"lastStore\": 12,\n        \"lastSalesperson\": null,\n        \"flags\": null\n    },\n    \"store\": 12,\n    \"tags\": [\n        {\n            \"tag\": 6,\n            \"name\": \"Customer\",\n            \"createdAt\": \"2026-05-28T20:20:26-03:00\"\n        },\n        {\n            \"tag\": 2,\n            \"name\": \"Opt-in\",\n            \"createdAt\": \"2026-05-28T20:18:34-03:00\"\n        },\n        {\n            \"tag\": 453,\n            \"name\": \"Cashback Silver - Boutique\",\n            \"createdAt\": \"2026-05-28T20:20:26-03:00\"\n        },\n        {\n            \"tag\": 90,\n            \"name\": \"Gold\",\n            \"createdAt\": \"2026-05-28T20:20:26-03:00\"\n        }\n    ],\n    \"referral\": {\n        \"person\": 4220011,\n        \"expiredAt\": \"2026-06-28T20:17:11-03:00\"\n    },\n    \"watchlist\": [\n        {\n            \"listType\": \"blocklist\",\n            \"reason\": \"fraud suspicion\",\n            \"syncedAt\": \"2026-05-28T20:17:11-03:00\"\n        }\n    ],\n    \"tier\": {\n        \"tierConfig\": 2,\n        \"activePoints\": 4810,\n        \"levelId\": 2,\n        \"levelName\": \"Gold\",\n        \"nextLevel\": \"Platinum\",\n        \"pointsToNext\": 3190\n    },\n    \"membership\": {\n        \"isMember\": true,\n        \"tierConfig\": 2,\n        \"joinedAt\": \"2026-05-28T23:18:34-03:00\"\n    },\n    \"lifecycle\": {\n        \"stage\": \"customer\",\n        \"churnAt\": \"2026-08-25T20:20:26-03:00\",\n        \"churnedAt\": null\n    },\n    \"metadata\": {\n        \"shirt_size\": \"M\",\n        \"kid_birthday\": \"2015-03-01\"\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Get or Create",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            },
                            {
                                "key": "User-Agent",
                                "value": "{{User-Agent}}",
                                "type": "text",
                                "description": ""
                            },
                            {
                                "key": "Signature",
                                "value": "{{Signature}}",
                                "type": "text",
                                "description": ""
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer/findOrCreate",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer",
                                "findOrCreate"
                            ]
                        },
                        "description": "Looks up a customer matching the provided identifiers (cellphone, email, document, etc.). If no match, creates a new customer with that data and returns it.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\r\n    \"name\": \"Tintin\",\r\n    \"email\": \"tintin@tintin.com.br\",\r\n    \"cellphone\": \"+55 19 9 8245-6598\",\r\n    \"id\": 23\r\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Found / created",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    },
                                    {
                                        "key": "User-Agent",
                                        "value": "{{User-Agent}}",
                                        "type": "text",
                                        "description": ""
                                    },
                                    {
                                        "key": "Signature",
                                        "value": "{{Signature}}",
                                        "type": "text",
                                        "description": ""
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/findOrCreate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "findOrCreate"
                                    ]
                                },
                                "description": "Looks up a customer matching the provided identifiers (cellphone, email, document, etc.). If no match, creates a new customer with that data and returns it.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\r\n    \"name\": \"Tintin\",\r\n    \"email\": \"tintin@tintin.com.br\",\r\n    \"cellphone\": \"+55 19 9 8245-6598\",\r\n    \"id\": 23\r\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 44,\n    \"created\": false,\n    \"name\": \"Maria Silva\",\n    \"cellphone\": \"19954264546\",\n    \"email\": \"maria@example.com\"\n}"
                        }
                    ]
                },
                {
                    "name": "Lifecycle",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer/lifecycle",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer",
                                "lifecycle"
                            ]
                        },
                        "description": "Returns a paginated list of customer **IDs** filtered by lifecycle stage or by\nchurn forecast. Reads directly from the scheduled lifecycle tags — `5` (Lead),\n`6` (Customer), `7` (Churn). See the [Customer Lifecycle guide](/en-US/guides/customer-lifecycle).\n\nUse it to build audiences such as *\"already churned\"* or *\"customers who will\nchurn within N days / by a given date\"* — ideal to feed campaigns, exports or\nintegrations. For a single customer's stage plus its churn forecast (`churnAt`),\nuse the `lifecycle` object in [Get customer](/en-US/api-reference/register/customer/get).\n\nProvide **either** `stage` **or** one of `churnWithinDays` / `churnUntil`.\nThe churn-forecast params imply the Customer stage (an active customer whose\npredicted churn date falls between now and the given ceiling) and take\nprecedence over `stage`."
                    },
                    "response": [
                        {
                            "name": "Success — churned customers (`?stage=churn`).",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/lifecycle",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "lifecycle"
                                    ]
                                },
                                "description": "Returns a paginated list of customer **IDs** filtered by lifecycle stage or by\nchurn forecast. Reads directly from the scheduled lifecycle tags — `5` (Lead),\n`6` (Customer), `7` (Churn). See the [Customer Lifecycle guide](/en-US/guides/customer-lifecycle).\n\nUse it to build audiences such as *\"already churned\"* or *\"customers who will\nchurn within N days / by a given date\"* — ideal to feed campaigns, exports or\nintegrations. For a single customer's stage plus its churn forecast (`churnAt`),\nuse the `lifecycle` object in [Get customer](/en-US/api-reference/register/customer/get).\n\nProvide **either** `stage` **or** one of `churnWithinDays` / `churnUntil`.\nThe churn-forecast params imply the Customer stage (an active customer whose\npredicted churn date falls between now and the given ceiling) and take\nprecedence over `stage`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [44356, 44409, 44411, 44526, 44202],\n    \"total\": 291721,\n    \"pagination\": { \"entries\": 5, \"totalPages\": 58345, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}"
                        },
                        {
                            "name": "Success — customers about to churn within 7 days (`?churnWithinDays=7`).",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/lifecycle",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "lifecycle"
                                    ]
                                },
                                "description": "Returns a paginated list of customer **IDs** filtered by lifecycle stage or by\nchurn forecast. Reads directly from the scheduled lifecycle tags — `5` (Lead),\n`6` (Customer), `7` (Churn). See the [Customer Lifecycle guide](/en-US/guides/customer-lifecycle).\n\nUse it to build audiences such as *\"already churned\"* or *\"customers who will\nchurn within N days / by a given date\"* — ideal to feed campaigns, exports or\nintegrations. For a single customer's stage plus its churn forecast (`churnAt`),\nuse the `lifecycle` object in [Get customer](/en-US/api-reference/register/customer/get).\n\nProvide **either** `stage` **or** one of `churnWithinDays` / `churnUntil`.\nThe churn-forecast params imply the Customer stage (an active customer whose\npredicted churn date falls between now and the given ceiling) and take\nprecedence over `stage`."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [4169452, 4169450, 4169459, 4169464, 4169463],\n    \"total\": 2252,\n    \"pagination\": { \"entries\": 5, \"totalPages\": 451, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}"
                        },
                        {
                            "name": "No filter provided.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/lifecycle",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "lifecycle"
                                    ]
                                },
                                "description": "Returns a paginated list of customer **IDs** filtered by lifecycle stage or by\nchurn forecast. Reads directly from the scheduled lifecycle tags — `5` (Lead),\n`6` (Customer), `7` (Churn). See the [Customer Lifecycle guide](/en-US/guides/customer-lifecycle).\n\nUse it to build audiences such as *\"already churned\"* or *\"customers who will\nchurn within N days / by a given date\"* — ideal to feed campaigns, exports or\nintegrations. For a single customer's stage plus its churn forecast (`churnAt`),\nuse the `lifecycle` object in [Get customer](/en-US/api-reference/register/customer/get).\n\nProvide **either** `stage` **or** one of `churnWithinDays` / `churnUntil`.\nThe churn-forecast params imply the Customer stage (an active customer whose\npredicted churn date falls between now and the given ceiling) and take\nprecedence over `stage`."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"error\": true,\n    \"message\": \"Provide stage (lead|customer|churn) or churnWithinDays/churnUntil\",\n    \"status_code\": 400\n}"
                        }
                    ]
                },
                {
                    "name": "List Customers",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer"
                            ]
                        },
                        "description": "Returns a paginated list of customers, and is also **how you look a customer up\nby e-mail, document or phone** — filter the listing instead of calling a\nseparate endpoint, because there is no separate endpoint.\n\nFiltering uses the shared listing grammar `q[column][operator]=value`,\ndocumented in full under [List query parameters](/docs/{lang}/guides/list-query-parameters).\nAny column of the response can be filtered.\n\n```\nGET /api/register/customer?q[email][E]=someone@example.com\nGET /api/register/customer?q[document][E]=12345678900\nGET /api/register/customer?q[email][LRL]=gmail&e=20\n```\n\n`E` is exact match — the one to use when you already have the address in hand.\n`LRL` is \"contains\", useful for partial searches. Combine columns freely.\n\nThe endpoint is read-only. To resolve an identifier **and create the customer\nif missing**, that is a different operation (`Get or create customer`) and it\nwrites — do not reach for it just to look someone up."
                    },
                    "response": [
                        {
                            "name": "Successful response",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer"
                                    ]
                                },
                                "description": "Returns a paginated list of customers, and is also **how you look a customer up\nby e-mail, document or phone** — filter the listing instead of calling a\nseparate endpoint, because there is no separate endpoint.\n\nFiltering uses the shared listing grammar `q[column][operator]=value`,\ndocumented in full under [List query parameters](/docs/{lang}/guides/list-query-parameters).\nAny column of the response can be filtered.\n\n```\nGET /api/register/customer?q[email][E]=someone@example.com\nGET /api/register/customer?q[document][E]=12345678900\nGET /api/register/customer?q[email][LRL]=gmail&e=20\n```\n\n`E` is exact match — the one to use when you already have the address in hand.\n`LRL` is \"contains\", useful for partial searches. Combine columns freely.\n\nThe endpoint is read-only. To resolve an identifier **and create the customer\nif missing**, that is a different operation (`Get or create customer`) and it\nwrites — do not reach for it just to look someone up."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\n            \"id\": 536813,\n            \"entityType\": \"individual\",\n            \"name\": \"Rodrigo Dechen\",\n            \"email\": \"rodrigo@gmail.com\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": \"11987654321\",\n            \"document\": null,\n            \"gender\": null,\n            \"dateOfBirth\": null,\n            \"createdAt\": \"2024-03-11T09:20:41-03:00\",\n            \"updatedAt\": \"2026-02-02T18:05:12-03:00\"\n        }\n    ],\n    \"total\": 1\n}"
                        }
                    ]
                },
                {
                    "name": "Merge",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/merge",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "merge"
                            ]
                        },
                        "description": "Merges two person records into one — useful when duplicates are detected. The resulting record keeps history from both.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\r\n    \"mainPersonId\": 123,\r\n    \"mergePersonIds\": [456, 789]\r\n  }",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Merged",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/merge",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "merge"
                                    ]
                                },
                                "description": "Merges two person records into one — useful when duplicates are detected. The resulting record keeps history from both.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\r\n    \"mainPersonId\": 123,\r\n    \"mergePersonIds\": [456, 789]\r\n  }",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"keep\": 44,\n    \"merged\": 102,\n    \"affectedRecords\": 17\n}"
                        }
                    ]
                },
                {
                    "name": "Metadata",
                    "item": [
                        {
                            "name": "Get customer metadata",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/metadata",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "metadata"
                                    ]
                                },
                                "description": "Returns the person's metadata (custom fields) as a flat `{ metaKey: value }`\nobject. The same object is also embedded as `metadata` in the full customer\npayload (`GET /api/register/customer/{id}`). An empty object is returned when\nthe person has no metadata."
                            },
                            "response": [
                                {
                                    "name": "Metadata map (empty object when the person has none).",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/metadata",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "metadata"
                                            ]
                                        },
                                        "description": "Returns the person's metadata (custom fields) as a flat `{ metaKey: value }`\nobject. The same object is also embedded as `metadata` in the full customer\npayload (`GET /api/register/customer/{id}`). An empty object is returned when\nthe person has no metadata."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"shirt_size\": \"M\",\n    \"kid_birthday\": \"2015-03-01\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Upsert customer metadata",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/metadata",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "metadata"
                                    ]
                                },
                                "description": "Partial upsert of a person's metadata. The body is a flat `{ metaKey: value }`\nobject — each key is created or updated. **Send a `null` or empty-string value\nto delete a key.** Keys not present in the body are left untouched.\n\nEach `metaKey` is slugified to `[a-z0-9_]` (max 64 chars) and rejected (422)\nif it collides with a fixed person column (e.g. `email`, `name`, `gender`).\nValues are stored as text; a numeric value also populates `valueNumber` and a\n`YYYY-MM-DD` value also populates `valueDate` (best-effort, for future\nsegmentation). New keys are auto-registered so they appear in the\n`custom-field` catalog.\n\nReturns the person's fresh, normalized metadata map.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"shirt_size\": \"G\",\n    \"kid_birthday\": \"2015-03-01\",\n    \"old_key\": null\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Fresh metadata map after the upsert.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/metadata",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "metadata"
                                            ]
                                        },
                                        "description": "Partial upsert of a person's metadata. The body is a flat `{ metaKey: value }`\nobject — each key is created or updated. **Send a `null` or empty-string value\nto delete a key.** Keys not present in the body are left untouched.\n\nEach `metaKey` is slugified to `[a-z0-9_]` (max 64 chars) and rejected (422)\nif it collides with a fixed person column (e.g. `email`, `name`, `gender`).\nValues are stored as text; a numeric value also populates `valueNumber` and a\n`YYYY-MM-DD` value also populates `valueDate` (best-effort, for future\nsegmentation). New keys are auto-registered so they appear in the\n`custom-field` catalog.\n\nReturns the person's fresh, normalized metadata map.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"shirt_size\": \"G\",\n    \"kid_birthday\": \"2015-03-01\",\n    \"old_key\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"shirt_size\": \"G\",\n    \"kid_birthday\": \"2015-03-01\"\n}"
                                },
                                {
                                    "name": "A `metaKey` collides with a fixed person column.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/metadata",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "metadata"
                                            ]
                                        },
                                        "description": "Partial upsert of a person's metadata. The body is a flat `{ metaKey: value }`\nobject — each key is created or updated. **Send a `null` or empty-string value\nto delete a key.** Keys not present in the body are left untouched.\n\nEach `metaKey` is slugified to `[a-z0-9_]` (max 64 chars) and rejected (422)\nif it collides with a fixed person column (e.g. `email`, `name`, `gender`).\nValues are stored as text; a numeric value also populates `valueNumber` and a\n`YYYY-MM-DD` value also populates `valueDate` (best-effort, for future\nsegmentation). New keys are auto-registered so they appear in the\n`custom-field` catalog.\n\nReturns the person's fresh, normalized metadata map.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"shirt_size\": \"G\",\n    \"kid_birthday\": \"2015-03-01\",\n    \"old_key\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "OptIn",
                    "item": [
                        {
                            "name": "Authorize",
                            "request": {
                                "method": "PATCH",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "optin"
                                    ]
                                },
                                "description": "Records the customer's authorization (opt-in) to use their data for marketing/communications."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "PATCH",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "optin"
                                            ]
                                        },
                                        "description": "Records the customer's authorization (opt-in) to use their data for marketing/communications."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2157344,\n    \"authorized\": true,\n    \"authorizedAt\": \"2025-07-04T13:30:35-03:00\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get Opt-in",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "optin"
                                    ]
                                },
                                "description": "Returns a single the customer matching the given identifier."
                            },
                            "response": [
                                {
                                    "name": "Authorized",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "optin"
                                            ]
                                        },
                                        "description": "Returns a single the customer matching the given identifier."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2157344,\n    \"authorized\": true,\n    \"authorizedAt\": \"2025-07-04T13:30:35-03:00\"\n}"
                                },
                                {
                                    "name": "Unauthorized",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "optin"
                                            ]
                                        },
                                        "description": "Returns a single the customer matching the given identifier."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2157344,\n    \"authorized\": false,\n    \"authorizedAt\": null\n}"
                                }
                            ]
                        },
                        {
                            "name": "Revoke",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "optin"
                                    ]
                                },
                                "description": "Revokes a previously granted opt-in. The customer's data is no longer used for marketing."
                            },
                            "response": [
                                {
                                    "name": "Sccess",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/optin",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "optin"
                                            ]
                                        },
                                        "description": "Revokes a previously granted opt-in. The customer's data is no longer used for marketing."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2157344,\n    \"authorized\": false,\n    \"authorizedAt\": null\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Pin",
                    "item": [
                        {
                            "name": "Generate",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/pin",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{person}}",
                                        "pin"
                                    ]
                                },
                                "description": "Generates a numeric PIN and sends it to the customer (SMS/email). Used as second-factor for high-value redemptions."
                            },
                            "response": [
                                {
                                    "name": "PIN sent",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/pin",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{person}}",
                                                "pin"
                                            ]
                                        },
                                        "description": "Generates a numeric PIN and sends it to the customer (SMS/email). Used as second-factor for high-value redemptions."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"channel\": \"whatsapp\",\n    \"sentTo\": \"+5519954264546\",\n    \"expiresAt\": \"2026-05-01T12:39:56-03:00\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Validate",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/pin/validate",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{person}}",
                                        "pin",
                                        "validate"
                                    ]
                                },
                                "description": "Validates a PIN entered by the customer at the POS or storefront. Returns success/failure.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\r\n    \"pin\": \"9663\"\r\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Valid",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/pin/validate",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{person}}",
                                                "pin",
                                                "validate"
                                            ]
                                        },
                                        "description": "Validates a PIN entered by the customer at the POS or storefront. Returns success/failure.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\r\n    \"pin\": \"9663\"\r\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"valid\": true }"
                                },
                                {
                                    "name": "Invalid",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/pin/validate",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{person}}",
                                                "pin",
                                                "validate"
                                            ]
                                        },
                                        "description": "Validates a PIN entered by the customer at the POS or storefront. Returns success/failure.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\r\n    \"pin\": \"9663\"\r\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unauthorized",
                                    "code": 401,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"valid\": false }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Referral",
                    "item": [
                        {
                            "name": "Create referral",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/referral",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "referral"
                                    ]
                                },
                                "description": "Records a \"*who-referred-whom*\" relationship between two customers. Each `person`\ncan only have **one** active referrer at a time:\n\n- If no referral exists for `person`, one is created.\n- If a referral exists and is still **active** (`expiredAt > now`), the endpoint\n  refuses to switch the `referrer` (HTTP 409). Sending the *same* `referrer`\n  with a new `expiredAt` extends the window.\n- If the existing referral has already **expired**, the new payload replaces it.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"person\": 620287,\n    \"referrer\": 609961,\n    \"expiredAt\": \"2026-12-31 23:59:59\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Referral created or extended.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/referral",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "referral"
                                            ]
                                        },
                                        "description": "Records a \"*who-referred-whom*\" relationship between two customers. Each `person`\ncan only have **one** active referrer at a time:\n\n- If no referral exists for `person`, one is created.\n- If a referral exists and is still **active** (`expiredAt > now`), the endpoint\n  refuses to switch the `referrer` (HTTP 409). Sending the *same* `referrer`\n  with a new `expiredAt` extends the window.\n- If the existing referral has already **expired**, the new payload replaces it.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"person\": 620287,\n    \"referrer\": 609961,\n    \"expiredAt\": \"2026-12-31 23:59:59\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"person\": 620287,\n    \"referrer\": 609961,\n    \"expiredAt\": \"2026-12-31T23:59:59-03:00\",\n    \"createdAt\": \"2026-05-03T10:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "A different referrer is already active for this person and has not expired yet.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/referral",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "referral"
                                            ]
                                        },
                                        "description": "Records a \"*who-referred-whom*\" relationship between two customers. Each `person`\ncan only have **one** active referrer at a time:\n\n- If no referral exists for `person`, one is created.\n- If a referral exists and is still **active** (`expiredAt > now`), the endpoint\n  refuses to switch the `referrer` (HTTP 409). Sending the *same* `referrer`\n  with a new `expiredAt` extends the window.\n- If the existing referral has already **expired**, the new payload replaces it.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"person\": 620287,\n    \"referrer\": 609961,\n    \"expiredAt\": \"2026-12-31 23:59:59\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 409,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List Referrals",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/referral",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "referral"
                                    ]
                                },
                                "description": "Lists the referrals recorded for the organization - who indicated whom."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/referral",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "referral"
                                            ]
                                        },
                                        "description": "Lists the referrals recorded for the organization - who indicated whom."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Remove customer",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer"
                            ]
                        },
                        "description": "Soft-deletes a customer (the model uses the standard `Tools\\Data\\Delete` flow which\nmarks the row as removed). The customer ID goes in the request body, not in the URL.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 683752\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Customer removed.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer"
                                    ]
                                },
                                "description": "Soft-deletes a customer (the model uses the standard `Tools\\Data\\Delete` flow which\nmarks the row as removed). The customer ID goes in the request body, not in the URL.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 683752\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "RFM",
                    "item": [
                        {
                            "name": "Get RFM",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/rfm",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{person}}",
                                        "rfm"
                                    ]
                                },
                                "description": "Returns the **R**ecency / **F**requency / **M**onetary record for a\nsingle person — first/last purchase, lifetime value, count, cadence,\nand the most recent reward card received. Refreshed automatically\nafter every order commit and whenever a reward card is issued.\n\nUsed by admin and segmentation flows to display a customer's\npurchasing snapshot. For listing many at once see\n[List RFM](/docs/{lang}/api-reference/register/customer/rfm/list)."
                            },
                            "response": [
                                {
                                    "name": "RFM snapshot",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/rfm",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{person}}",
                                                "rfm"
                                            ]
                                        },
                                        "description": "Returns the **R**ecency / **F**requency / **M**onetary record for a\nsingle person — first/last purchase, lifetime value, count, cadence,\nand the most recent reward card received. Refreshed automatically\nafter every order commit and whenever a reward card is issued.\n\nUsed by admin and segmentation flows to display a customer's\npurchasing snapshot. For listing many at once see\n[List RFM](/docs/{lang}/api-reference/register/customer/rfm/list)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"person\":                  643,\n    \"firstPurchaseId\":         211,\n    \"lastPurchaseId\":          1142,\n    \"firstPurchaseDate\":       \"2024-01-09T09:34:13-03:00\",\n    \"lastPurchaseDate\":        \"2026-04-22T17:48:00-03:00\",\n    \"averagePurchaseInterval\": 28.4,\n    \"totalPurchaseValue\":      398900,\n    \"totalPurchases\":          12,\n    \"daysWithoutPurchase\":     12,\n    \"lastRewardCardId\":        9821,\n    \"lastRewardCardDate\":      \"2026-04-22T17:48:03-03:00\",\n    \"nextUpdateDate\":          \"2026-05-04T03:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "Person has no purchase history yet",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{person}}/rfm",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{person}}",
                                                "rfm"
                                            ]
                                        },
                                        "description": "Returns the **R**ecency / **F**requency / **M**onetary record for a\nsingle person — first/last purchase, lifetime value, count, cadence,\nand the most recent reward card received. Refreshed automatically\nafter every order commit and whenever a reward card is issued.\n\nUsed by admin and segmentation flows to display a customer's\npurchasing snapshot. For listing many at once see\n[List RFM](/docs/{lang}/api-reference/register/customer/rfm/list)."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"error\": \"not_found\", \"message\": \"rfm not found\" }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Tags",
                    "item": [
                        {
                            "name": "Assign tags to a customer",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{personId}}/tags",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{personId}}",
                                        "tags"
                                    ]
                                },
                                "description": "Attaches one or more tags to a customer. The body is a **JSON array of tag\ninteger IDs**. For each tag: a `person_tag_history` row is recorded with\n`action = QUALIFIED` and the tag is inserted; if the link already exists, its\n`count` column is incremented (`ON DUPLICATE KEY UPDATE count = count + 1`).\n\nThe response is a flat list of *all* tag IDs currently attached to the customer.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "[101, 102, 103]",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated list of tag IDs attached to the customer.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{personId}}/tags",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{personId}}",
                                                "tags"
                                            ]
                                        },
                                        "description": "Attaches one or more tags to a customer. The body is a **JSON array of tag\ninteger IDs**. For each tag: a `person_tag_history` row is recorded with\n`action = QUALIFIED` and the tag is inserted; if the link already exists, its\n`count` column is incremented (`ON DUPLICATE KEY UPDATE count = count + 1`).\n\nThe response is a flat list of *all* tag IDs currently attached to the customer.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "[101, 102, 103]",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[1, 101, 102, 103]"
                                }
                            ]
                        },
                        {
                            "name": "Remove tags from a customer",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{personId}}/tags",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{personId}}",
                                        "tags"
                                    ]
                                },
                                "description": "Detaches one or more tags from a customer. The body is a **JSON array of tag\ninteger IDs**. For each tag a `person_tag_history` row is recorded with\n`action = REMOVED` and the link in `person_tag` is deleted. The response is a\nflat list of the tag IDs that *remain* attached to the customer.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "[101, 102]",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Remaining tag IDs after removal.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{personId}}/tags",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{personId}}",
                                                "tags"
                                            ]
                                        },
                                        "description": "Detaches one or more tags from a customer. The body is a **JSON array of tag\ninteger IDs**. For each tag a `person_tag_history` row is recorded with\n`action = REMOVED` and the link in `person_tag` is deleted. The response is a\nflat list of the tag IDs that *remain* attached to the customer.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "[101, 102]",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[1, 103]"
                                }
                            ]
                        },
                        {
                            "name": "List Tags",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/tags",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "{{id}}",
                                        "tags"
                                    ]
                                },
                                "description": "Returns the active tags of a customer as a paginated list of **tag IDs**.\n\nThe list includes the customer **lifecycle** stage — `5` (Lead), `6` (Customer)\nor `7` (Churn), assigned automatically. See the Customer Lifecycle guide. For the\nstage plus the churn forecast (`churnAt`), use the `lifecycle` object in\n[Get customer](/en-US/api-reference/register/customer/get)."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/customer/{{id}}/tags",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "customer",
                                                "{{id}}",
                                                "tags"
                                            ]
                                        },
                                        "description": "Returns the active tags of a customer as a paginated list of **tag IDs**.\n\nThe list includes the customer **lifecycle** stage — `5` (Lead), `6` (Customer)\nor `7` (Churn), assigned automatically. See the Customer Lifecycle guide. For the\nstage plus the churn forecast (`churnAt`), use the `lifecycle` object in\n[Get customer](/en-US/api-reference/register/customer/get)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"list\": [6, 2, 453, 90],\n    \"total\": 4,\n    \"pagination\": { \"entries\": 50, \"totalPages\": 1, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": true }\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Update customer",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer"
                            ]
                        },
                        "description": "Updates a customer record. Only `id` is required; any other field present in the\nbody is updated, anything omitted is left untouched. Same sanitization as the\ncreate endpoint (phone via libphonenumber, email lower-cased, document stripped\nto alphanumeric).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 683752,\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"41236587422\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\",\n    \"optin\": \"2026-05-03T10:00:00-03:00\",\n    \"privacyAccepted\": \"2026-05-03T10:00:00-03:00\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Customer updated.",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer"
                                    ]
                                },
                                "description": "Updates a customer record. Only `id` is required; any other field present in the\nbody is updated, anything omitted is left untouched. Same sanitization as the\ncreate endpoint (phone via libphonenumber, email lower-cased, document stripped\nto alphanumeric).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 683752,\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"41236587422\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\",\n    \"optin\": \"2026-05-03T10:00:00-03:00\",\n    \"privacyAccepted\": \"2026-05-03T10:00:00-03:00\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 683752,\n    \"name\": \"Tintin\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"document\": \"41236587422\",\n    \"gender\": \"male\",\n    \"postalCode\": \"13450000\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"language\": \"pt_BR\",\n    \"updatedAt\": \"2026-05-03T10:00:00-03:00\"\n}"
                        }
                    ]
                },
                {
                    "name": "Update customers in batch",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/customer/batch",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "customer",
                                "batch"
                            ]
                        },
                        "description": "Updates **many customers in one call** — a list of items, each with its `id`\nand the fields to change. Use it instead of looping the single update: setting\nthe same field on hundreds of customers (e.g. `entityType=legal`) or importing\nper-customer values all go in one request.\n\nEach item reuses the **exact same path as the single update** (same\nsanitization and validation; only `id` is required per item, anything omitted is\nleft untouched). A bad item does **not** fail the batch: the response reports an\n`outcome` per item — `updated`, `not_found`, or `rejected` (with the reason) —\nplus a `summary` of counts.\n\nPass **`dryRun: true`** to validate without writing: every eligible item comes\nback as `would_update` and nothing is changed. Up to **100 items** per call.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n  \"items\": [\n    { \"id\": 683752, \"entityType\": \"legal\" },\n    { \"id\": 683999, \"entityType\": \"legal\" },\n    { \"id\": 684010, \"name\": \"Tintin\", \"email\": \"tintim@guper.co\" }\n  ],\n  \"dryRun\": false\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Batch processed (per-item outcomes; individual failures do not fail the batch).",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/batch",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "batch"
                                    ]
                                },
                                "description": "Updates **many customers in one call** — a list of items, each with its `id`\nand the fields to change. Use it instead of looping the single update: setting\nthe same field on hundreds of customers (e.g. `entityType=legal`) or importing\nper-customer values all go in one request.\n\nEach item reuses the **exact same path as the single update** (same\nsanitization and validation; only `id` is required per item, anything omitted is\nleft untouched). A bad item does **not** fail the batch: the response reports an\n`outcome` per item — `updated`, `not_found`, or `rejected` (with the reason) —\nplus a `summary` of counts.\n\nPass **`dryRun: true`** to validate without writing: every eligible item comes\nback as `would_update` and nothing is changed. Up to **100 items** per call.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"items\": [\n    { \"id\": 683752, \"entityType\": \"legal\" },\n    { \"id\": 683999, \"entityType\": \"legal\" },\n    { \"id\": 684010, \"name\": \"Tintin\", \"email\": \"tintim@guper.co\" }\n  ],\n  \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"dryRun\": false,\n  \"total\": 3,\n  \"summary\": { \"updated\": 2, \"notFound\": 1, \"rejected\": 0 },\n  \"results\": [\n    { \"id\": 683752, \"outcome\": \"updated\" },\n    { \"id\": 683999, \"outcome\": \"updated\" },\n    { \"id\": 684010, \"outcome\": \"not_found\" }\n  ]\n}"
                        },
                        {
                            "name": "Malformed request: no `items`, more than 100, or an item without a numeric `id`.",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/customer/batch",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "customer",
                                        "batch"
                                    ]
                                },
                                "description": "Updates **many customers in one call** — a list of items, each with its `id`\nand the fields to change. Use it instead of looping the single update: setting\nthe same field on hundreds of customers (e.g. `entityType=legal`) or importing\nper-customer values all go in one request.\n\nEach item reuses the **exact same path as the single update** (same\nsanitization and validation; only `id` is required per item, anything omitted is\nleft untouched). A bad item does **not** fail the batch: the response reports an\n`outcome` per item — `updated`, `not_found`, or `rejected` (with the reason) —\nplus a `summary` of counts.\n\nPass **`dryRun: true`** to validate without writing: every eligible item comes\nback as `would_update` and nothing is changed. Up to **100 items** per call.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n  \"items\": [\n    { \"id\": 683752, \"entityType\": \"legal\" },\n    { \"id\": 683999, \"entityType\": \"legal\" },\n    { \"id\": 684010, \"name\": \"Tintin\", \"email\": \"tintim@guper.co\" }\n  ],\n  \"dryRun\": false\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Datacapture",
            "item": [
                {
                    "name": "Form",
                    "item": [
                        {
                            "name": "Create data-capture form",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "form"
                                    ]
                                },
                                "description": "Defines a data-capture form template (e.g. opt-in/lead form). Each form is a\n`name` plus a list of `fields`. The form must include a field whose `name`\nmatches the organization's primary identifier (first column of `matchPattern`,\ntypically `cellphone` or `email`); that field is automatically marked as\n`required: true` and `identifier: true`.\n\nA field can also be flagged with `metadata: true` so its captured value is\nstored as **person metadata** (a custom key/value field) instead of being\ndropped. See the *Custom Fields* guide and the `custom-field` endpoints.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"name\",\n            \"label\": \"Nome\",\n            \"type\": \"text\",\n            \"required\": true,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Form created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Defines a data-capture form template (e.g. opt-in/lead form). Each form is a\n`name` plus a list of `fields`. The form must include a field whose `name`\nmatches the organization's primary identifier (first column of `matchPattern`,\ntypically `cellphone` or `email`); that field is automatically marked as\n`required: true` and `identifier: true`.\n\nA field can also be flagged with `metadata: true` so its captured value is\nstored as **person metadata** (a custom key/value field) instead of being\ndropped. See the *Custom Fields* guide and the `custom-field` endpoints.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"name\",\n            \"label\": \"Nome\",\n            \"type\": \"text\",\n            \"required\": true,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"name\": \"optin\",\n    \"fields\": [\n        { \"name\": \"name\",      \"label\": \"Nome\",     \"type\": \"text\",  \"required\": true },\n        { \"name\": \"email\",     \"label\": \"E-mail\",   \"type\": \"email\", \"required\": true, \"identifier\": true },\n        { \"name\": \"cellphone\", \"label\": \"Telefone\", \"type\": \"text\",  \"required\": false },\n        { \"name\": \"shirt_size\", \"label\": \"Tamanho\", \"type\": \"text\",  \"required\": false, \"metadata\": true, \"metaKey\": \"shirt_size\" }\n    ]\n}"
                                },
                                {
                                    "name": "Form does not include the organization identifier field.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Defines a data-capture form template (e.g. opt-in/lead form). Each form is a\n`name` plus a list of `fields`. The form must include a field whose `name`\nmatches the organization's primary identifier (first column of `matchPattern`,\ntypically `cellphone` or `email`); that field is automatically marked as\n`required: true` and `identifier: true`.\n\nA field can also be flagged with `metadata: true` so its captured value is\nstored as **person metadata** (a custom key/value field) instead of being\ndropped. See the *Custom Fields* guide and the `custom-field` endpoints.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"name\",\n            \"label\": \"Nome\",\n            \"type\": \"text\",\n            \"required\": true,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Get Capture Form",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "form",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single data capture form with its fields."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single data capture form with its fields."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List Capture Forms",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "form"
                                    ]
                                },
                                "description": "Returns a paginated list of resources."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Returns a paginated list of resources."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Remove data-capture form",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "form"
                                    ]
                                },
                                "description": "Soft-deletes a data-capture form. The ID goes in the request body, not in the\nURL.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Form removed.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Soft-deletes a data-capture form. The ID goes in the request body, not in the\nURL.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update data-capture form",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "form"
                                    ]
                                },
                                "description": "Updates a data-capture form definition. Only `id` is required; if `fields` is\nsent it goes through the same identifier-validation as on create — the\norganization's primary identifier field must be present and will be flagged as\n`required: true` and `identifier: true`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"phone\",\n            \"label\": \"Telefone\",\n            \"type\": \"text\",\n            \"required\": false,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Form updated.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Updates a data-capture form definition. Only `id` is required; if `fields` is\nsent it goes through the same identifier-validation as on create — the\norganization's primary identifier field must be present and will be flagged as\n`required: true` and `identifier: true`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"phone\",\n            \"label\": \"Telefone\",\n            \"type\": \"text\",\n            \"required\": false,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "When `fields` is sent and does not include the organization identifier.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/form",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "form"
                                            ]
                                        },
                                        "description": "Updates a data-capture form definition. Only `id` is required; if `fields` is\nsent it goes through the same identifier-validation as on create — the\norganization's primary identifier field must be present and will be flagged as\n`required: true` and `identifier: true`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"name\": \"optin\",\n    \"fields\": [\n        {\n            \"name\": \"phone\",\n            \"label\": \"Telefone\",\n            \"type\": \"text\",\n            \"required\": false,\n            \"metadata\": false,\n            \"metaKey\": \"shirt_size\"\n        }\n    ]\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Render Form",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/{{formID}}/render/{{sID}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "datacapture",
                                "{{formID}}",
                                "render",
                                "{{sID}}"
                            ]
                        },
                        "description": "Renders a configurable data-capture form (HTML) for a given submission session — typically embedded in storefront landing pages."
                    },
                    "response": [
                        {
                            "name": "Success",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/{{formID}}/render/{{sID}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "{{formID}}",
                                        "render",
                                        "{{sID}}"
                                    ]
                                },
                                "description": "Renders a configurable data-capture form (HTML) for a given submission session — typically embedded in storefront landing pages."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"submissionKey\": \"xyz987654\",\n  \"fields\": [\n    { \n        \"name\": \"name\", \n        \"label\": \"Nome\", \n        \"type\": \"text\", \n        \"required\": true\n    },\n    { \n        \"name\": \"email\", \n        \"label\": \"E-mail\", \n        \"type\": \"email\", \n        \"required\": true\n    },\n    { \n        \"name\": \"phone\", \n        \"label\": \"Telefone\", \n        \"type\": \"text\", \n        \"required\": false\n    }\n  ]\n}"
                        }
                    ]
                },
                {
                    "name": "Source",
                    "item": [
                        {
                            "name": "Create source ID",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "sid"
                                    ]
                                },
                                "description": "Registers a *Source ID* (SID) — a short alias used to track the origin of a\nsubmission (campaign, channel, physical placement, etc.). SIDs are paired with\na form ID at render time to produce a `submissionKey`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"alias\": \"outdoor\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Source ID created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "sid"
                                            ]
                                        },
                                        "description": "Registers a *Source ID* (SID) — a short alias used to track the origin of a\nsubmission (campaign, channel, physical placement, etc.). SIDs are paired with\na form ID at render time to produce a `submissionKey`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"alias\": \"outdoor\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"alias\": \"outdoor\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get Source",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "sid",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Request for registering people"
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "sid",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Request for registering people"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List Sources",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "sid"
                                    ]
                                },
                                "description": "Returns a paginated list of resources."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "sid"
                                            ]
                                        },
                                        "description": "Returns a paginated list of resources."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Remove source ID",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "sid"
                                    ]
                                },
                                "description": "Soft-deletes a *Source ID*. The ID goes in the request body, not in the URL.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Source ID removed.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "sid"
                                            ]
                                        },
                                        "description": "Soft-deletes a *Source ID*. The ID goes in the request body, not in the URL.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update source ID",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "sid"
                                    ]
                                },
                                "description": "Updates a *Source ID* — typically just to rename the alias.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"alias\": \"outdoor\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Source ID updated.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/sid",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "datacapture",
                                                "sid"
                                            ]
                                        },
                                        "description": "Updates a *Source ID* — typically just to rename the alias.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"alias\": \"outdoor\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Submit data-capture form",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/datacapture/submit/{{submissionKey}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "datacapture",
                                "submit",
                                "{{submissionKey}}"
                            ]
                        },
                        "description": "Submits the values entered in a previously rendered data-capture form.\n\nThe body is a **flat JSON object** whose keys match the form's field `name`s.\nThe value for the organization's identifier field (first column of\n`matchPattern` — usually `cellphone` or `email`) is required and must be\nunique within `(organization, formId, identifierValue)` — re-submitting the\nsame identifier on the same form returns HTTP 409.\n\nOn success the row is persisted in `register.formData` and the original\npayload is echoed back. Authentication is **not** required on this endpoint\n(the `submissionKey` itself is the credential — anyone holding it can submit).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Maria Oliveira\",\n    \"email\": \"maria@exemplo.com\",\n    \"cellphone\": \"+5511999999999\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Submission stored. Echoes the payload back.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/submit/{{submissionKey}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "submit",
                                        "{{submissionKey}}"
                                    ]
                                },
                                "description": "Submits the values entered in a previously rendered data-capture form.\n\nThe body is a **flat JSON object** whose keys match the form's field `name`s.\nThe value for the organization's identifier field (first column of\n`matchPattern` — usually `cellphone` or `email`) is required and must be\nunique within `(organization, formId, identifierValue)` — re-submitting the\nsame identifier on the same form returns HTTP 409.\n\nOn success the row is persisted in `register.formData` and the original\npayload is echoed back. Authentication is **not** required on this endpoint\n(the `submissionKey` itself is the credential — anyone holding it can submit).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Maria Oliveira\",\n    \"email\": \"maria@exemplo.com\",\n    \"cellphone\": \"+5511999999999\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"name\": \"Maria Oliveira\",\n    \"email\": \"maria@exemplo.com\",\n    \"cellphone\": \"+5511999999999\"\n}"
                        },
                        {
                            "name": "Missing `submissionKey` or missing the organization identifier field in the body.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/submit/{{submissionKey}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "submit",
                                        "{{submissionKey}}"
                                    ]
                                },
                                "description": "Submits the values entered in a previously rendered data-capture form.\n\nThe body is a **flat JSON object** whose keys match the form's field `name`s.\nThe value for the organization's identifier field (first column of\n`matchPattern` — usually `cellphone` or `email`) is required and must be\nunique within `(organization, formId, identifierValue)` — re-submitting the\nsame identifier on the same form returns HTTP 409.\n\nOn success the row is persisted in `register.formData` and the original\npayload is echoed back. Authentication is **not** required on this endpoint\n(the `submissionKey` itself is the credential — anyone holding it can submit).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Maria Oliveira\",\n    \"email\": \"maria@exemplo.com\",\n    \"cellphone\": \"+5511999999999\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        },
                        {
                            "name": "Duplicate — the identifier value has already been submitted on this form.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/datacapture/submit/{{submissionKey}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "datacapture",
                                        "submit",
                                        "{{submissionKey}}"
                                    ]
                                },
                                "description": "Submits the values entered in a previously rendered data-capture form.\n\nThe body is a **flat JSON object** whose keys match the form's field `name`s.\nThe value for the organization's identifier field (first column of\n`matchPattern` — usually `cellphone` or `email`) is required and must be\nunique within `(organization, formId, identifierValue)` — re-submitting the\nsame identifier on the same form returns HTTP 409.\n\nOn success the row is persisted in `register.formData` and the original\npayload is echoed back. Authentication is **not** required on this endpoint\n(the `submissionKey` itself is the credential — anyone holding it can submit).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Maria Oliveira\",\n    \"email\": \"maria@exemplo.com\",\n    \"cellphone\": \"+5511999999999\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 409,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Event",
            "item": [
                {
                    "name": "Search customers by event",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/event/search",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "event",
                                "search"
                            ]
                        },
                        "description": "Returns the **audience** (the list of customers) who have a recorded event in\n`person_event` of a given `type`, optionally narrowed by free-text terms and a\ndate window. This is the generic, event-based audience search — the same engine\nbehind the QON `event` filter, exposed as a simple `GET`.\n\nGeneric by `type`:\n\n- `type=buy_product` — customers who **bought a product**; `terms[]` match the\n  product name (`description`), **all terms ANDed** (substring, case- and\n  accent-insensitive). e.g. `terms[]=tennis&terms[]=preto` matches a customer who\n  bought *\"calçado tennis nike 42 preto e branco\"*.\n- `type=membership_joined` — customers who **joined** in the window; no `terms`\n  (membership events have no `description`).\n- any future event type (`abandoned_cart`, `app_open`, …) works the same way.\n\n`from`/`to` (`YYYY-MM-DD`) bound `occurredAt` (`to` is exclusive at the next day).\n\n**Scope:** this endpoint resolves the *event* criteria only. Demographic/behavioral\ncomposition (gender, age, RFM, tag, tier) is the audience builder's responsibility\nvia the QON `event` filter — see *Internal › Services › Register › Audiência por evento*.\n\nAuth: service-to-service RSA `signature` (see *Internal › Integração › Signature*).\nOrganization is taken from the request context.\n\n### Worked examples\n\nCustomers who bought a product whose name contains **\"tennis\" AND \"preto\"**, in 2026:\n\n```\nGET /api/register/event/search?type=buy_product&terms[]=tennis&terms[]=preto&from=2026-01-01&to=2026-07-01\n```\n\nCustomers who **joined membership** in the same window (no terms):\n\n```\nGET /api/register/event/search?type=membership_joined&from=2026-01-01&to=2026-07-01\n```\n\nResponse (`AudienceResult` — paginated; `entries=0` streams all rows):\n\n```json\n{\n    \"total\": 144262,\n    \"data\": [\n        { \"id\": 4293432, \"name\": \"John Doe\", \"email\": \"j@x.com\", \"gender\": \"male\" }\n    ],\n    \"pagination\": { \"entries\": 50, \"totalPages\": 2886, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}\n```"
                    },
                    "response": [
                        {
                            "name": "Audience (customers) matching the event criteria.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/event/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "event",
                                        "search"
                                    ]
                                },
                                "description": "Returns the **audience** (the list of customers) who have a recorded event in\n`person_event` of a given `type`, optionally narrowed by free-text terms and a\ndate window. This is the generic, event-based audience search — the same engine\nbehind the QON `event` filter, exposed as a simple `GET`.\n\nGeneric by `type`:\n\n- `type=buy_product` — customers who **bought a product**; `terms[]` match the\n  product name (`description`), **all terms ANDed** (substring, case- and\n  accent-insensitive). e.g. `terms[]=tennis&terms[]=preto` matches a customer who\n  bought *\"calçado tennis nike 42 preto e branco\"*.\n- `type=membership_joined` — customers who **joined** in the window; no `terms`\n  (membership events have no `description`).\n- any future event type (`abandoned_cart`, `app_open`, …) works the same way.\n\n`from`/`to` (`YYYY-MM-DD`) bound `occurredAt` (`to` is exclusive at the next day).\n\n**Scope:** this endpoint resolves the *event* criteria only. Demographic/behavioral\ncomposition (gender, age, RFM, tag, tier) is the audience builder's responsibility\nvia the QON `event` filter — see *Internal › Services › Register › Audiência por evento*.\n\nAuth: service-to-service RSA `signature` (see *Internal › Integração › Signature*).\nOrganization is taken from the request context.\n\n### Worked examples\n\nCustomers who bought a product whose name contains **\"tennis\" AND \"preto\"**, in 2026:\n\n```\nGET /api/register/event/search?type=buy_product&terms[]=tennis&terms[]=preto&from=2026-01-01&to=2026-07-01\n```\n\nCustomers who **joined membership** in the same window (no terms):\n\n```\nGET /api/register/event/search?type=membership_joined&from=2026-01-01&to=2026-07-01\n```\n\nResponse (`AudienceResult` — paginated; `entries=0` streams all rows):\n\n```json\n{\n    \"total\": 144262,\n    \"data\": [\n        { \"id\": 4293432, \"name\": \"John Doe\", \"email\": \"j@x.com\", \"gender\": \"male\" }\n    ],\n    \"pagination\": { \"entries\": 50, \"totalPages\": 2886, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}\n```"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"total\": 144262,\n    \"data\": [\n        { \"id\": 4293432, \"name\": \"John Doe\", \"email\": \"j@x.com\", \"gender\": \"male\" }\n    ],\n    \"pagination\": { \"entries\": 50, \"totalPages\": 2886, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}"
                        },
                        {
                            "name": "`type` was not supplied.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/event/search",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "event",
                                        "search"
                                    ]
                                },
                                "description": "Returns the **audience** (the list of customers) who have a recorded event in\n`person_event` of a given `type`, optionally narrowed by free-text terms and a\ndate window. This is the generic, event-based audience search — the same engine\nbehind the QON `event` filter, exposed as a simple `GET`.\n\nGeneric by `type`:\n\n- `type=buy_product` — customers who **bought a product**; `terms[]` match the\n  product name (`description`), **all terms ANDed** (substring, case- and\n  accent-insensitive). e.g. `terms[]=tennis&terms[]=preto` matches a customer who\n  bought *\"calçado tennis nike 42 preto e branco\"*.\n- `type=membership_joined` — customers who **joined** in the window; no `terms`\n  (membership events have no `description`).\n- any future event type (`abandoned_cart`, `app_open`, …) works the same way.\n\n`from`/`to` (`YYYY-MM-DD`) bound `occurredAt` (`to` is exclusive at the next day).\n\n**Scope:** this endpoint resolves the *event* criteria only. Demographic/behavioral\ncomposition (gender, age, RFM, tag, tier) is the audience builder's responsibility\nvia the QON `event` filter — see *Internal › Services › Register › Audiência por evento*.\n\nAuth: service-to-service RSA `signature` (see *Internal › Integração › Signature*).\nOrganization is taken from the request context.\n\n### Worked examples\n\nCustomers who bought a product whose name contains **\"tennis\" AND \"preto\"**, in 2026:\n\n```\nGET /api/register/event/search?type=buy_product&terms[]=tennis&terms[]=preto&from=2026-01-01&to=2026-07-01\n```\n\nCustomers who **joined membership** in the same window (no terms):\n\n```\nGET /api/register/event/search?type=membership_joined&from=2026-01-01&to=2026-07-01\n```\n\nResponse (`AudienceResult` — paginated; `entries=0` streams all rows):\n\n```json\n{\n    \"total\": 144262,\n    \"data\": [\n        { \"id\": 4293432, \"name\": \"John Doe\", \"email\": \"j@x.com\", \"gender\": \"male\" }\n    ],\n    \"pagination\": { \"entries\": 50, \"totalPages\": 2886, \"currentPage\": 1, \"isInitial\": true, \"isEnd\": false }\n}\n```"
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"type is required\" }"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Feedback",
            "item": [
                {
                    "name": "Category",
                    "item": [
                        {
                            "name": "Create feedback category",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "category"
                                    ]
                                },
                                "description": "Creates a new feedback category. Use this to define the topics you want\ncustomers to evaluate (e.g. *delivery*, *product*, *attendance*). Categories\nare optional on reviews — only create the ones you actually plan to use.\n\n`slug` is unique per organization (`UNIQUE(organization, slug)`); attempting\nto reuse an existing slug returns a database conflict.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Evaluates the delivery experience.\",\n    \"active\": 1,\n    \"data\": \"<data>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Category created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category"
                                            ]
                                        },
                                        "description": "Creates a new feedback category. Use this to define the topics you want\ncustomers to evaluate (e.g. *delivery*, *product*, *attendance*). Categories\nare optional on reviews — only create the ones you actually plan to use.\n\n`slug` is unique per organization (`UNIQUE(organization, slug)`); attempting\nto reuse an existing slug returns a database conflict.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Evaluates the delivery experience.\",\n    \"active\": 1,\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Evaluates the delivery experience.\",\n    \"active\": 1,\n    \"data\": null,\n    \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n    \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Delete feedback category",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "category"
                                    ]
                                },
                                "description": "Permanently deletes a feedback category. The foreign key from\n`feedback_review.categoryId` is `ON DELETE RESTRICT`, so the operation\nfails if any review still references the category. Prefer\n`PUT /feedback/category` with `active: 0` to retire a category that already\nhas reviews.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Category deleted.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category"
                                            ]
                                        },
                                        "description": "Permanently deletes a feedback category. The foreign key from\n`feedback_review.categoryId` is `ON DELETE RESTRICT`, so the operation\nfails if any review still references the category. Prefer\n`PUT /feedback/category` with `active: 0` to retire a category that already\nhas reviews.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "Category is in use by one or more reviews — soft-retire it instead by setting `active: 0`.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category"
                                            ]
                                        },
                                        "description": "Permanently deletes a feedback category. The foreign key from\n`feedback_review.categoryId` is `ON DELETE RESTRICT`, so the operation\nfails if any review still references the category. Prefer\n`PUT /feedback/category` with `active: 0` to retire a category that already\nhas reviews.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 409,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List feedback categories",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "category"
                                    ]
                                },
                                "description": "Lists feedback categories for the organization. Categories are an optional\ntaxonomy used to group reviews (e.g. *delivery*, *product*, *service*) — a\nreview may be uncategorized (`categoryId: null`) when the organization has\nnot adopted a catalog yet.\n\nSupports the standard `q[col][OP]=value` listing filters (see *List query\nparameters*). Common filters: `q[active][]=1`, `q[slug][]=delivery`."
                            },
                            "response": [
                                {
                                    "name": "List of categories.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category"
                                            ]
                                        },
                                        "description": "Lists feedback categories for the organization. Categories are an optional\ntaxonomy used to group reviews (e.g. *delivery*, *product*, *service*) — a\nreview may be uncategorized (`categoryId: null`) when the organization has\nnot adopted a catalog yet.\n\nSupports the standard `q[col][OP]=value` listing filters (see *List query\nparameters*). Common filters: `q[active][]=1`, `q[slug][]=delivery`."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"total\": 2,\n    \"page\": 1,\n    \"rowsPerPage\": 20,\n    \"list\": [\n        {\n            \"id\": 1,\n            \"slug\": \"delivery\",\n            \"name\": \"Delivery\",\n            \"description\": \"Evaluates the delivery experience.\",\n            \"active\": 1,\n            \"data\": null,\n            \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n            \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n        },\n        {\n            \"id\": 2,\n            \"slug\": \"product\",\n            \"name\": \"Product\",\n            \"description\": null,\n            \"active\": 1,\n            \"data\": null,\n            \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n            \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n        }\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get feedback category",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/category/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "category",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single feedback category by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                            },
                            "response": [
                                {
                                    "name": "Category found.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single feedback category by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Evaluates the delivery experience.\",\n    \"active\": 1,\n    \"data\": null,\n    \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n    \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "Category not found in this organization.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single feedback category by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update feedback category",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "category"
                                    ]
                                },
                                "description": "Updates an existing feedback category. The `id` is required in the body;\nany other supplied field is overwritten. Categories cannot be deleted while\nthey are referenced by at least one review — set `active: 0` to retire them\nsoftly instead.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Updated description.\",\n    \"active\": 0,\n    \"data\": \"<data>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Category updated.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/category",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "category"
                                            ]
                                        },
                                        "description": "Updates an existing feedback category. The `id` is required in the body;\nany other supplied field is overwritten. Categories cannot be deleted while\nthey are referenced by at least one review — set `active: 0` to retire them\nsoftly instead.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"slug\": \"delivery\",\n    \"name\": \"Delivery\",\n    \"description\": \"Updated description.\",\n    \"active\": 0,\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Review",
                    "item": [
                        {
                            "name": "Create feedback review",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review"
                                    ]
                                },
                                "description": "Records a customer review for a specific order. Exactly **one** review per\norder is allowed — a second `POST` for the same `orderId` returns `409`.\n\nThe review carries a `type` discriminator that tells which scale the\n`rating` follows:\n\n- `type: csat` — rating from **1 to 5** (Customer Satisfaction)\n- `type: nps`  — rating from **0 to 10** (Net Promoter Score)\n\n`comment` is always required (free-form text, must not be empty after\n`trim`). `categoryId` is optional — supply it only if the organization has\ncreated the corresponding category beforehand. When omitted, the review is\nuncategorized.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"categoryId\": 1,\n    \"source\": \"journey\",\n    \"data\": \"<data>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Review created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review"
                                            ]
                                        },
                                        "description": "Records a customer review for a specific order. Exactly **one** review per\norder is allowed — a second `POST` for the same `orderId` returns `409`.\n\nThe review carries a `type` discriminator that tells which scale the\n`rating` follows:\n\n- `type: csat` — rating from **1 to 5** (Customer Satisfaction)\n- `type: nps`  — rating from **0 to 10** (Net Promoter Score)\n\n`comment` is always required (free-form text, must not be empty after\n`trim`). `categoryId` is optional — supply it only if the organization has\ncreated the corresponding category beforehand. When omitted, the review is\nuncategorized.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"categoryId\": 1,\n    \"source\": \"journey\",\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"categoryId\": 1,\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"source\": \"journey\",\n    \"data\": null,\n    \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n    \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "Validation error — invalid `type`, `rating` out of range for the chosen `type`, empty `comment`, or `categoryId` does not belong to this organization.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review"
                                            ]
                                        },
                                        "description": "Records a customer review for a specific order. Exactly **one** review per\norder is allowed — a second `POST` for the same `orderId` returns `409`.\n\nThe review carries a `type` discriminator that tells which scale the\n`rating` follows:\n\n- `type: csat` — rating from **1 to 5** (Customer Satisfaction)\n- `type: nps`  — rating from **0 to 10** (Net Promoter Score)\n\n`comment` is always required (free-form text, must not be empty after\n`trim`). `categoryId` is optional — supply it only if the organization has\ncreated the corresponding category beforehand. When omitted, the review is\nuncategorized.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"categoryId\": 1,\n    \"source\": \"journey\",\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "A review already exists for this order. Use `PUT /feedback/review/{id}` to amend instead.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review"
                                            ]
                                        },
                                        "description": "Records a customer review for a specific order. Exactly **one** review per\norder is allowed — a second `POST` for the same `orderId` returns `409`.\n\nThe review carries a `type` discriminator that tells which scale the\n`rating` follows:\n\n- `type: csat` — rating from **1 to 5** (Customer Satisfaction)\n- `type: nps`  — rating from **0 to 10** (Net Promoter Score)\n\n`comment` is always required (free-form text, must not be empty after\n`trim`). `categoryId` is optional — supply it only if the organization has\ncreated the corresponding category beforehand. When omitted, the review is\nuncategorized.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"categoryId\": 1,\n    \"source\": \"journey\",\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 409,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Delete feedback review",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Permanently removes a review by id. Intended for administrative moderation\n(e.g. spam, mis-tagged orders) — the regular customer flow should not\nexpose this endpoint."
                            },
                            "response": [
                                {
                                    "name": "Review deleted.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Permanently removes a review by id. Intended for administrative moderation\n(e.g. spam, mis-tagged orders) — the regular customer flow should not\nexpose this endpoint."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "Review not found in this organization.",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Permanently removes a review by id. Intended for administrative moderation\n(e.g. spam, mis-tagged orders) — the regular customer flow should not\nexpose this endpoint."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List feedback reviews",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review"
                                    ]
                                },
                                "description": "Lists per-order feedback reviews. Supports the standard `q[col][OP]=value`\nlisting filters (see *List query parameters*). Useful filters:\n\n- `q[type][]=csat` or `q[type][]=nps`\n- `q[rating][GTE]=4` — promoters/satisfied customers\n- `q[rating][LTE]=2` — detractors\n- `q[personId][]=12345` — all reviews from a customer\n- `q[categoryId][]=3` — by category"
                            },
                            "response": [
                                {
                                    "name": "List of reviews.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review"
                                            ]
                                        },
                                        "description": "Lists per-order feedback reviews. Supports the standard `q[col][OP]=value`\nlisting filters (see *List query parameters*). Useful filters:\n\n- `q[type][]=csat` or `q[type][]=nps`\n- `q[rating][GTE]=4` — promoters/satisfied customers\n- `q[rating][LTE]=2` — detractors\n- `q[personId][]=12345` — all reviews from a customer\n- `q[categoryId][]=3` — by category"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"total\": 2,\n    \"page\": 1,\n    \"rowsPerPage\": 20,\n    \"list\": [\n        {\n            \"id\": 1,\n            \"personId\": 12345,\n            \"orderId\": \"ORD-789\",\n            \"type\": \"csat\",\n            \"categoryId\": 1,\n            \"rating\": 5,\n            \"comment\": \"Great delivery, on time and well packaged.\",\n            \"source\": \"journey\",\n            \"data\": null,\n            \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n            \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n        },\n        {\n            \"id\": 2,\n            \"personId\": 67890,\n            \"orderId\": \"ORD-790\",\n            \"type\": \"nps\",\n            \"categoryId\": null,\n            \"rating\": 10,\n            \"comment\": \"Would definitely recommend.\",\n            \"source\": \"journey\",\n            \"data\": null,\n            \"createdAt\": \"2026-05-14T11:05:00-03:00\",\n            \"updatedAt\": \"2026-05-14T11:05:00-03:00\"\n        }\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get feedback review",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single feedback review by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                            },
                            "response": [
                                {
                                    "name": "Review found.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single feedback review by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"categoryId\": 1,\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"source\": \"journey\",\n    \"data\": null,\n    \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n    \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "Review not found in this organization.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single feedback review by its numeric `id`. Returns `404` when\nthe id does not exist in the requesting organization."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Get feedback review by order",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/byOrder/{{orderId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review",
                                        "byOrder",
                                        "{{orderId}}"
                                    ]
                                },
                                "description": "Returns the review attached to a given `orderId`. Because the schema\nenforces `UNIQUE(organization, orderId)`, this lookup always returns at\nmost one review.\n\nUseful in flows that want to check *whether* a customer has already\nreviewed a given order before sending an invitation — a `404` means the\norder has no review yet."
                            },
                            "response": [
                                {
                                    "name": "Review found.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/byOrder/{{orderId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "byOrder",
                                                "{{orderId}}"
                                            ]
                                        },
                                        "description": "Returns the review attached to a given `orderId`. Because the schema\nenforces `UNIQUE(organization, orderId)`, this lookup always returns at\nmost one review.\n\nUseful in flows that want to check *whether* a customer has already\nreviewed a given order before sending an invitation — a `404` means the\norder has no review yet."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"personId\": 12345,\n    \"orderId\": \"ORD-789\",\n    \"type\": \"csat\",\n    \"categoryId\": 1,\n    \"rating\": 5,\n    \"comment\": \"Great delivery, on time and well packaged.\",\n    \"source\": \"journey\",\n    \"data\": null,\n    \"createdAt\": \"2026-05-14T11:00:00-03:00\",\n    \"updatedAt\": \"2026-05-14T11:00:00-03:00\"\n}"
                                },
                                {
                                    "name": "No review yet for this order.",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/byOrder/{{orderId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "byOrder",
                                                "{{orderId}}"
                                            ]
                                        },
                                        "description": "Returns the review attached to a given `orderId`. Because the schema\nenforces `UNIQUE(organization, orderId)`, this lookup always returns at\nmost one review.\n\nUseful in flows that want to check *whether* a customer has already\nreviewed a given order before sending an invitation — a `404` means the\norder has no review yet."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update feedback review",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "feedback",
                                        "review",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing review by id. Only the fields you send are touched —\neverything else stays as it was.\n\nSwitching `type` mid-stream is allowed but the resulting `rating` must\nstill fall in the new range:\n\n- if you change `type` from `csat` to `nps`, the existing rating (1..5)\n  stays valid (still inside 0..10), but you may also send a higher rating.\n- if you change from `nps` to `csat` and the existing rating is `6..10`,\n  you **must** send a new rating in the 1..5 range or the request is\n  rejected with `400`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"type\": \"nps\",\n    \"rating\": 9,\n    \"comment\": \"Updated feedback after the carrier reached out.\",\n    \"categoryId\": 2,\n    \"data\": \"<data>\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Review updated.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Updates an existing review by id. Only the fields you send are touched —\neverything else stays as it was.\n\nSwitching `type` mid-stream is allowed but the resulting `rating` must\nstill fall in the new range:\n\n- if you change `type` from `csat` to `nps`, the existing rating (1..5)\n  stays valid (still inside 0..10), but you may also send a higher rating.\n- if you change from `nps` to `csat` and the existing rating is `6..10`,\n  you **must** send a new rating in the 1..5 range or the request is\n  rejected with `400`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"type\": \"nps\",\n    \"rating\": 9,\n    \"comment\": \"Updated feedback after the carrier reached out.\",\n    \"categoryId\": 2,\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "Validation error — invalid `type`, rating outside the resulting range, empty `comment`, or `categoryId` does not belong to this organization.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Updates an existing review by id. Only the fields you send are touched —\neverything else stays as it was.\n\nSwitching `type` mid-stream is allowed but the resulting `rating` must\nstill fall in the new range:\n\n- if you change `type` from `csat` to `nps`, the existing rating (1..5)\n  stays valid (still inside 0..10), but you may also send a higher rating.\n- if you change from `nps` to `csat` and the existing rating is `6..10`,\n  you **must** send a new rating in the 1..5 range or the request is\n  rejected with `400`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"type\": \"nps\",\n    \"rating\": 9,\n    \"comment\": \"Updated feedback after the carrier reached out.\",\n    \"categoryId\": 2,\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                },
                                {
                                    "name": "Review not found in this organization.",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/feedback/review/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "feedback",
                                                "review",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Updates an existing review by id. Only the fields you send are touched —\neverything else stays as it was.\n\nSwitching `type` mid-stream is allowed but the resulting `rating` must\nstill fall in the new range:\n\n- if you change `type` from `csat` to `nps`, the existing rating (1..5)\n  stays valid (still inside 0..10), but you may also send a higher rating.\n- if you change from `nps` to `csat` and the existing rating is `6..10`,\n  you **must** send a new rating in the 1..5 range or the request is\n  rejected with `400`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"type\": \"nps\",\n    \"rating\": 9,\n    \"comment\": \"Updated feedback after the carrier reached out.\",\n    \"categoryId\": 2,\n    \"data\": \"<data>\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Membership",
            "item": [
                {
                    "name": "Active at",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/active-at",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "membership",
                                "{{personId}}",
                                "active-at"
                            ]
                        },
                        "description": "Tells whether a person was an active member of a tier program at a given point in time.\nUseful when you need to gate a feature, award, or message by the membership state at the date of an event (e.g. order placed at).\n\nA member is \"active at `date`\" when:\n`joinedAt <= date AND (leftAt IS NULL OR date < leftAt)`.\n\nThe `tierConfig` can be provided directly, or resolved indirectly from a tag (the tag must be listed in `tag_tier_filter` for the organization)."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/active-at",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}",
                                        "active-at"
                                    ]
                                },
                                "description": "Tells whether a person was an active member of a tier program at a given point in time.\nUseful when you need to gate a feature, award, or message by the membership state at the date of an event (e.g. order placed at).\n\nA member is \"active at `date`\" when:\n`joinedAt <= date AND (leftAt IS NULL OR date < leftAt)`.\n\nThe `tierConfig` can be provided directly, or resolved indirectly from a tag (the tag must be listed in `tag_tier_filter` for the organization)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"person\":     4131293,\n    \"tierConfig\": 1,\n    \"date\":       \"2026-04-28T03:51:13+00:00\",\n    \"active\":     false\n}"
                        },
                        {
                            "name": "Missing tierConfig or tag query parameter.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/active-at",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}",
                                        "active-at"
                                    ]
                                },
                                "description": "Tells whether a person was an active member of a tier program at a given point in time.\nUseful when you need to gate a feature, award, or message by the membership state at the date of an event (e.g. order placed at).\n\nA member is \"active at `date`\" when:\n`joinedAt <= date AND (leftAt IS NULL OR date < leftAt)`.\n\nThe `tierConfig` can be provided directly, or resolved indirectly from a tag (the tag must be listed in `tag_tier_filter` for the organization)."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Join",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/membership",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "membership"
                            ]
                        },
                        "description": "Records a person joining (or rejoining) a tier program.\n\nMost memberships are created automatically by the tag hook: assigning a person a tag that is listed in `tag_tier_filter` triggers a join. This endpoint covers cases where the membership must be created manually (e.g. admin action, data import, special enrollment flow).\n\n**Idempotent**:\n- If no row exists → INSERT, history `joined`.\n- If row exists and is active (`leftAt IS NULL`) → no-op.\n- If row exists and was closed (`leftAt IS NOT NULL`) → clears `leftAt`, updates `joinedAt`, history `rejoined`.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"person\": 4131293,\n    \"tierConfig\": 1,\n    \"joinedAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Joined / Rejoined / No-op",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership"
                                    ]
                                },
                                "description": "Records a person joining (or rejoining) a tier program.\n\nMost memberships are created automatically by the tag hook: assigning a person a tag that is listed in `tag_tier_filter` triggers a join. This endpoint covers cases where the membership must be created manually (e.g. admin action, data import, special enrollment flow).\n\n**Idempotent**:\n- If no row exists → INSERT, history `joined`.\n- If row exists and is active (`leftAt IS NULL`) → no-op.\n- If row exists and was closed (`leftAt IS NOT NULL`) → clears `leftAt`, updates `joinedAt`, history `rejoined`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"person\": 4131293,\n    \"tierConfig\": 1,\n    \"joinedAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"action\": \"joined\" }"
                        },
                        {
                            "name": "Already active",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership"
                                    ]
                                },
                                "description": "Records a person joining (or rejoining) a tier program.\n\nMost memberships are created automatically by the tag hook: assigning a person a tag that is listed in `tag_tier_filter` triggers a join. This endpoint covers cases where the membership must be created manually (e.g. admin action, data import, special enrollment flow).\n\n**Idempotent**:\n- If no row exists → INSERT, history `joined`.\n- If row exists and is active (`leftAt IS NULL`) → no-op.\n- If row exists and was closed (`leftAt IS NOT NULL`) → clears `leftAt`, updates `joinedAt`, history `rejoined`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"person\": 4131293,\n    \"tierConfig\": 1,\n    \"joinedAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"action\": \"noop\" }"
                        },
                        {
                            "name": "Re-enrolled after leaving",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership"
                                    ]
                                },
                                "description": "Records a person joining (or rejoining) a tier program.\n\nMost memberships are created automatically by the tag hook: assigning a person a tag that is listed in `tag_tier_filter` triggers a join. This endpoint covers cases where the membership must be created manually (e.g. admin action, data import, special enrollment flow).\n\n**Idempotent**:\n- If no row exists → INSERT, history `joined`.\n- If row exists and is active (`leftAt IS NULL`) → no-op.\n- If row exists and was closed (`leftAt IS NOT NULL`) → clears `leftAt`, updates `joinedAt`, history `rejoined`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"person\": 4131293,\n    \"tierConfig\": 1,\n    \"joinedAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"action\": \"rejoined\" }"
                        },
                        {
                            "name": "Missing required field.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership"
                                    ]
                                },
                                "description": "Records a person joining (or rejoining) a tier program.\n\nMost memberships are created automatically by the tag hook: assigning a person a tag that is listed in `tag_tier_filter` triggers a join. This endpoint covers cases where the membership must be created manually (e.g. admin action, data import, special enrollment flow).\n\n**Idempotent**:\n- If no row exists → INSERT, history `joined`.\n- If row exists and is active (`leftAt IS NULL`) → no-op.\n- If row exists and was closed (`leftAt IS NOT NULL`) → clears `leftAt`, updates `joinedAt`, history `rejoined`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"person\": 4131293,\n    \"tierConfig\": 1,\n    \"joinedAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Leave",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/{{tierConfig}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "membership",
                                "{{personId}}",
                                "{{tierConfig}}"
                            ]
                        },
                        "description": "Closes an active membership by setting `leftAt`.\n\nMost \"leaves\" happen automatically: removing a person tag that is listed in `tag_tier_filter` triggers a leave via the tag hook. This endpoint covers manual or programmatic leaves (admin opt-out, account closure, special workflow).\n\n**Idempotent**:\n- No row, or row already has `leftAt` → no-op.\n- Active row → UPDATE sets `leftAt`, history `left`.\n\nThe membership row is **kept** (not deleted) so the historical timeline remains queryable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"leftAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Left",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/{{tierConfig}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}",
                                        "{{tierConfig}}"
                                    ]
                                },
                                "description": "Closes an active membership by setting `leftAt`.\n\nMost \"leaves\" happen automatically: removing a person tag that is listed in `tag_tier_filter` triggers a leave via the tag hook. This endpoint covers manual or programmatic leaves (admin opt-out, account closure, special workflow).\n\n**Idempotent**:\n- No row, or row already has `leftAt` → no-op.\n- Active row → UPDATE sets `leftAt`, history `left`.\n\nThe membership row is **kept** (not deleted) so the historical timeline remains queryable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"leftAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"action\": \"left\" }"
                        },
                        {
                            "name": "Already inactive (or never a member)",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/{{tierConfig}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}",
                                        "{{tierConfig}}"
                                    ]
                                },
                                "description": "Closes an active membership by setting `leftAt`.\n\nMost \"leaves\" happen automatically: removing a person tag that is listed in `tag_tier_filter` triggers a leave via the tag hook. This endpoint covers manual or programmatic leaves (admin opt-out, account closure, special workflow).\n\n**Idempotent**:\n- No row, or row already has `leftAt` → no-op.\n- Active row → UPDATE sets `leftAt`, history `left`.\n\nThe membership row is **kept** (not deleted) so the historical timeline remains queryable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"leftAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"action\": \"noop\" }"
                        },
                        {
                            "name": "Missing personId or tierConfig.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}/{{tierConfig}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}",
                                        "{{tierConfig}}"
                                    ]
                                },
                                "description": "Closes an active membership by setting `leftAt`.\n\nMost \"leaves\" happen automatically: removing a person tag that is listed in `tag_tier_filter` triggers a leave via the tag hook. This endpoint covers manual or programmatic leaves (admin opt-out, account closure, special workflow).\n\n**Idempotent**:\n- No row, or row already has `leftAt` → no-op.\n- Active row → UPDATE sets `leftAt`, history `left`.\n\nThe membership row is **kept** (not deleted) so the historical timeline remains queryable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"leftAt\": \"2026-05-27T10:00:00-03:00\",\n    \"source\": \"manual\",\n    \"sourceRef\": \"admin:42\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Customer loyalty-program memberships",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "membership",
                                "{{personId}}"
                            ]
                        },
                        "description": "Whether a customer is a **member / associate** of a loyalty program and since\nwhen. Returns every membership of ONE person inside the\norganization — active (no `leftAt`) and historical (with `leftAt`). A person can\nbelong to more than one tier program; one row per `tierConfig`.\n\nThis is **per-customer** (`membership` is the source of truth for \"is this person\nan associate\"; the membership tag is only a mirror). It does **not** aggregate:\nfor org-wide numbers (how many members, revenue from members, member-to-buyer\nconversion) there is no report endpoint yet — that needs a direct query. Use\n`active-at` to know if the person was a member on a given date."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/membership/{{personId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "membership",
                                        "{{personId}}"
                                    ]
                                },
                                "description": "Whether a customer is a **member / associate** of a loyalty program and since\nwhen. Returns every membership of ONE person inside the\norganization — active (no `leftAt`) and historical (with `leftAt`). A person can\nbelong to more than one tier program; one row per `tierConfig`.\n\nThis is **per-customer** (`membership` is the source of truth for \"is this person\nan associate\"; the membership tag is only a mirror). It does **not** aggregate:\nfor org-wide numbers (how many members, revenue from members, member-to-buyer\nconversion) there is no report endpoint yet — that needs a direct query. Use\n`active-at` to know if the person was a member on a given date."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "[\n    {\n        \"tierConfig\": 1,\n        \"joinedAt\":   \"2026-04-28 01:14:27\",\n        \"leftAt\":     null,\n        \"isActive\":   true,\n        \"source\":     \"tag_hook\",\n        \"sourceRef\":  \"546\"\n    },\n    {\n        \"tierConfig\": 2,\n        \"joinedAt\":   \"2025-09-10 17:02:00\",\n        \"leftAt\":     \"2026-03-15 09:30:00\",\n        \"isActive\":   false,\n        \"source\":     \"manual\",\n        \"sourceRef\":  \"admin:42\"\n    }\n]"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Payment",
            "item": [
                {
                    "name": "By-entity",
                    "item": [
                        {
                            "name": "List refs of a Payment",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/payment-external-ref/by-payment/{{paymentId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "payment-external-ref",
                                        "by-payment",
                                        "{{paymentId}}"
                                    ]
                                },
                                "description": "Lists every external `refId` mapped to one payment, one row per `source` (interface).\n\nReverse of `/api/register/{interface}/payment/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the payment has no mapping. Does not 404 on an unknown id."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/payment-external-ref/by-payment/{{paymentId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "payment-external-ref",
                                                "by-payment",
                                                "{{paymentId}}"
                                            ]
                                        },
                                        "description": "Lists every external `refId` mapped to one payment, one row per `source` (interface).\n\nReverse of `/api/register/{interface}/payment/{refId}`: that one goes refId -> entity,\nthis one goes entity -> refIds. Mirrors `/api/register/person-external-ref/by-person/{personId}`.\n\nReturns an empty array when the payment has no mapping. Does not 404 on an unknown id."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"refId\":\"VTEX-001\",\"source\":\"vtex\"},{\"refId\":\"11-2\",\"source\":\"pos\"}]"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "By-interface",
                    "item": [
                        {
                            "name": "Link Payment ref to existing entity",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Links this `refId` to an existing entity (passed by `paymentId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"paymentId\": 42\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Links this `refId` to an existing entity (passed by `paymentId`). Idempotent: if the ref already points to the same entity, no-op. If it pointed to a different entity, overwrites (PUT semantics). Returns 404 if the entity does not exist in the org.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"paymentId\": 42\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_linked\":true}"
                                }
                            ]
                        },
                        {
                            "name": "List Payment refs",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment"
                                    ]
                                },
                                "description": "Lists every external ref for `payment` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment"
                                            ]
                                        },
                                        "description": "Lists every external ref for `payment` mapped under the given `{interface}` (e.g. `vtex`, `shopify`, `cegid`) for the org. Returns each ref's entity id, name and `_ref` metadata."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}},{\"id\":89,\"name\":\"Adidas\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-ADIDAS-001\"}}]"
                                }
                            ]
                        },
                        {
                            "name": "Get Payment by ref",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Reads the entity linked to this `refId` under the `{interface}`. Returns 404 if no ref exists. Pure read - does not create anything."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"}}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Payment ref",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Removes only the external ref. The underlying entity is NOT deleted (use the canonical entity DELETE for that). Returns 404 if the ref does not exist."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"success\":true}"
                                }
                            ]
                        },
                        {
                            "name": "Bulk resolve Payment refs",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/_resolve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment",
                                        "_resolve"
                                    ]
                                },
                                "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment/_resolve",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment",
                                                "_resolve"
                                            ]
                                        },
                                        "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> entityId | null`. Up to 500 refIds per request. Optimized for the order processing hot path (single SQL with IN vs N round-trips).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"(array of strings)\": \"[\\\"VTEX-NIKE-001\\\", \\\"VTEX-ADIDAS-001\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"VTEX-NIKE-001\":42,\"VTEX-ADIDAS-001\":89,\"FAKE-DOES-NOT-EXIST\":null}"
                                }
                            ]
                        },
                        {
                            "name": "Create or get Payment ref",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "payment"
                                    ]
                                },
                                "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/payment",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "payment"
                                            ]
                                        },
                                        "description": "Find-or-create: if a ref with this `refId` already exists for the interface, returns the linked entity (no-op, `_created: false`). Otherwise creates a new entity with the given `name` AND the external ref pointing to it (`_created: true`). Idempotent on retry.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"refId\": \"VTEX-NIKE-001\",\n    \"name\": \"Nike\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":42,\"name\":\"Nike\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"VTEX-NIKE-001\"},\"_created\":true}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create payment method",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/payment",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "payment"
                            ]
                        },
                        "description": "Registers a payment method (`register.payment` row) for the organization. The\ncontroller accepts both the canonical field names (`id`, `name`, `type`) and\ntheir VTEX-style aliases (`paymentSystem`, `paymentSystemName`,\n`paymentSystemType`); aliases win when both are sent. When `name`/`type` are\nomitted the values default to `UNNAMED`/`UNTYPED`.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": \"1\",\n    \"name\": \"Pix\",\n    \"type\": \"pix\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Payment method created.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/payment",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "payment"
                                    ]
                                },
                                "description": "Registers a payment method (`register.payment` row) for the organization. The\ncontroller accepts both the canonical field names (`id`, `name`, `type`) and\ntheir VTEX-style aliases (`paymentSystem`, `paymentSystemName`,\n`paymentSystemType`); aliases win when both are sent. When `name`/`type` are\nomitted the values default to `UNNAMED`/`UNTYPED`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": \"1\",\n    \"name\": \"Pix\",\n    \"type\": \"pix\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": \"1\",\n    \"name\": \"Pix\",\n    \"type\": \"pix\"\n}"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Person",
            "item": [
                {
                    "name": "By-interface",
                    "item": [
                        {
                            "name": "Link person ref (by role)",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "person",
                                        "{{role}}",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Links this `refId` + `{role}` to an existing person (passed by `personId`). Idempotent. Returns 404 if the person does not exist in the org. Persons are NOT created via external_ref - they must already exist (use register customer/person endpoints to create).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"personId\": 620977\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "person",
                                                "{{role}}",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Links this `refId` + `{role}` to an existing person (passed by `personId`). Idempotent. Returns 404 if the person does not exist in the org. Persons are NOT created via external_ref - they must already exist (use register customer/person endpoints to create).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 620977\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":620977,\"name\":\"Alice\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"99\",\"role\":\"cashier\"},\"_linked\":true}"
                                }
                            ]
                        },
                        {
                            "name": "List person refs (by role)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "person",
                                        "{{role}}"
                                    ]
                                },
                                "description": "Lists every external person ref for the given `{role}` (cashier/salesperson/manager/client) under the `{interface}`. Returns each ref's personId, name and `_ref` metadata (including role)."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "person",
                                                "{{role}}"
                                            ]
                                        },
                                        "description": "Lists every external person ref for the given `{role}` (cashier/salesperson/manager/client) under the `{interface}`. Returns each ref's personId, name and `_ref` metadata (including role)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[{\"id\":620977,\"name\":\"Alice\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"99\",\"role\":\"cashier\"}},{\"id\":620980,\"name\":\"Bob\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"100\",\"role\":\"cashier\"}}]"
                                }
                            ]
                        },
                        {
                            "name": "Get person ref (by role)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "person",
                                        "{{role}}",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Reads the person linked to this `refId` for the given `{role}` under the `{interface}`. Returns 404 if no ref exists for that combination. Roles are independent: the same `refId` can resolve to different persons in different roles."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "person",
                                                "{{role}}",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Reads the person linked to this `refId` for the given `{role}` under the `{interface}`. Returns 404 if no ref exists for that combination. Roles are independent: the same `refId` can resolve to different persons in different roles."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"id\":620977,\"name\":\"Alice\",\"_ref\":{\"source\":\"vtex\",\"refId\":\"99\",\"role\":\"cashier\"}}"
                                }
                            ]
                        },
                        {
                            "name": "Remove person ref (by role)",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "person",
                                        "{{role}}",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Removes only this `refId` + `{role}` external ref. The underlying person is NOT deleted. Other roles for the same refId are unaffected."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "person",
                                                "{{role}}",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Removes only this `refId` + `{role}` external ref. The underlying person is NOT deleted. Other roles for the same refId are unaffected."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"success\":true}"
                                }
                            ]
                        },
                        {
                            "name": "Bulk resolve person refs (by role)",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/_resolve",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "{{interface}}",
                                        "person",
                                        "{{role}}",
                                        "_resolve"
                                    ]
                                },
                                "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> personId | null` for the given `{role}`. Up to 500 refIds. Optimized for order/translate hot paths.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"(array of strings)\": \"[\\\"99\\\", \\\"100\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/{{interface}}/person/{{role}}/_resolve",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "{{interface}}",
                                                "person",
                                                "{{role}}",
                                                "_resolve"
                                            ]
                                        },
                                        "description": "Bulk lookup: pass a JSON array of refIds, get back a map `refId -> personId | null` for the given `{role}`. Up to 500 refIds. Optimized for order/translate hot paths.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"(array of strings)\": \"[\\\"99\\\", \\\"100\\\", \\\"FAKE-DOES-NOT-EXIST\\\"]\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\"99\":620977,\"100\":620980,\"FAKE-DOES-NOT-EXIST\":null}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Create person",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person"
                            ]
                        },
                        "description": "Creates a record in `register.person` **without** flagging it as customer, user\nor collaborator (none of `isCustomer`/`isUser`/`isCollaborator` is set). Use\nthis when you just want a generic identity in the directory; for customer-only\nrows use `POST /api/register/customer` instead.\n\n`name` is required and at least one of `cellphone`, `email` or `document` must\nbe supplied. The payload goes through `Person\\Sanitize` (phone via\nlibphonenumber, email lower-cased, document stripped to alphanumerics).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Person created.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person"
                                    ]
                                },
                                "description": "Creates a record in `register.person` **without** flagging it as customer, user\nor collaborator (none of `isCustomer`/`isUser`/`isCollaborator` is set). Use\nthis when you just want a generic identity in the directory; for customer-only\nrows use `POST /api/register/customer` instead.\n\n`name` is required and at least one of `cellphone`, `email` or `document` must\nbe supplied. The payload goes through `Person\\Sanitize` (phone via\nlibphonenumber, email lower-cased, document stripped to alphanumerics).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 683752,\n    \"mainId\": null,\n    \"entityType\": \"individual\",\n    \"name\": \"Tintin\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"document\": null,\n    \"language\": \"pt_BR\",\n    \"createdAt\": \"2026-05-03T10:00:00-03:00\",\n    \"updatedAt\": \"2026-05-03T10:00:00-03:00\"\n}"
                        },
                        {
                            "name": "Insufficient data — none of `name`, `cellphone`, `email`, `document` were provided.",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person"
                                    ]
                                },
                                "description": "Creates a record in `register.person` **without** flagging it as customer, user\nor collaborator (none of `isCustomer`/`isUser`/`isCollaborator` is set). Use\nthis when you just want a generic identity in the directory; for customer-only\nrows use `POST /api/register/customer` instead.\n\n`name` is required and at least one of `cellphone`, `email` or `document` must\nbe supplied. The payload goes through `Person\\Sanitize` (phone via\nlibphonenumber, email lower-cased, document stripped to alphanumerics).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintim@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 412,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Get Person",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/{{idPerson}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "{{idPerson}}"
                            ]
                        },
                        "description": "Request for registering people"
                    },
                    "response": [
                        {
                            "name": "Successful Response",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{idPerson}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{idPerson}}"
                                    ]
                                },
                                "description": "Request for registering people"
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"id\": 47,\n    \"name\": \"Tintim\",\n    \"email\": \"tintim@tintim.com.br\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19966659986\",\n    \"document\": null,\n    \"language\": \"pt_BR\"\n}"
                        }
                    ]
                },
                {
                    "name": "Create invite",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/invite/{{idPerson}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "invite",
                                "{{idPerson}}"
                            ]
                        },
                        "description": "Issues an **invite token** for an existing person so they can later create\nConnect login credentials. This is the **first step** of the user-onboarding\nflow:\n\n1. The person already exists in Register (created via [Create Person](/docs/{lang}/api-reference/register/person/create) or imported from a customer feed).\n2. An admin calls this endpoint with the person's `idPerson` and receives an `inviteToken`.\n3. The token is delivered to the new user (e-mail link, magic link, QR code, etc.).\n4. The user submits the token plus their chosen `login` and `password` to [Connect · Create User](/docs/{lang}/api-reference/connect/user/create-user).\n5. Connect decrypts the token, verifies the organization + `personId`, and writes the User record.\n\nThe token is **URL-encoded** (so it can ride in a query string) and **RSA-encrypted** with Connect's public key — only Connect can decrypt it, and only for the organization the token was issued under. It's single-use: once a User is created, the token can't be redeemed again."
                    },
                    "response": [
                        {
                            "name": "Invite token issued",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/invite/{{idPerson}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "invite",
                                        "{{idPerson}}"
                                    ]
                                },
                                "description": "Issues an **invite token** for an existing person so they can later create\nConnect login credentials. This is the **first step** of the user-onboarding\nflow:\n\n1. The person already exists in Register (created via [Create Person](/docs/{lang}/api-reference/register/person/create) or imported from a customer feed).\n2. An admin calls this endpoint with the person's `idPerson` and receives an `inviteToken`.\n3. The token is delivered to the new user (e-mail link, magic link, QR code, etc.).\n4. The user submits the token plus their chosen `login` and `password` to [Connect · Create User](/docs/{lang}/api-reference/connect/user/create-user).\n5. Connect decrypts the token, verifies the organization + `personId`, and writes the User record.\n\nThe token is **URL-encoded** (so it can ride in a query string) and **RSA-encrypted** with Connect's public key — only Connect can decrypt it, and only for the organization the token was issued under. It's single-use: once a User is created, the token can't be redeemed again."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"inviteToken\": \"MAjLGiKVeKFG97TaYTDwmcEgOvrICbdAgo7t%2BytNC%2FV6hJ3fSBKbLh%2F7Oju3wHli4ELaOUH0AsyWlEs%2B4hzccAZmhnG0mmLmayN2VZCQmLZbLSYVwOfW14xJ9nof5LWmHWLeazwby%2BJuYkei8Poh04Eune00pIHAvWU6Vlr3Rbk%3D\",\n    \"dateTime\":    \"2026-05-01T12:34:56-03:00\"\n}"
                        },
                        {
                            "name": "Person not found",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/invite/{{idPerson}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "invite",
                                        "{{idPerson}}"
                                    ]
                                },
                                "description": "Issues an **invite token** for an existing person so they can later create\nConnect login credentials. This is the **first step** of the user-onboarding\nflow:\n\n1. The person already exists in Register (created via [Create Person](/docs/{lang}/api-reference/register/person/create) or imported from a customer feed).\n2. An admin calls this endpoint with the person's `idPerson` and receives an `inviteToken`.\n3. The token is delivered to the new user (e-mail link, magic link, QR code, etc.).\n4. The user submits the token plus their chosen `login` and `password` to [Connect · Create User](/docs/{lang}/api-reference/connect/user/create-user).\n5. Connect decrypts the token, verifies the organization + `personId`, and writes the User record.\n\nThe token is **URL-encoded** (so it can ride in a query string) and **RSA-encrypted** with Connect's public key — only Connect can decrypt it, and only for the organization the token was issued under. It's single-use: once a User is created, the token can't be redeemed again."
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"not_found\", \"message\": \"Person not found in this organization\" }"
                        }
                    ]
                },
                {
                    "name": "List People",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person"
                            ]
                        },
                        "description": "Returns the paginated list of system users (admin/staff/dev)."
                    },
                    "response": [
                        {
                            "name": "Successful Response",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person"
                                    ]
                                },
                                "description": "Returns the paginated list of system users (admin/staff/dev)."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\n            \"id\": 616,\n            \"entityType\": null,\n            \"name\": \"Renan\",\n            \"email\": null,\n            \"countryCallingCode\": null,\n            \"cellphone\": null,\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2023-10-17T14:32:53-03:00\",\n            \"updatedAt\": \"2024-01-09T14:40:28-03:00\"\n        },\n        {\n            \"id\": 661,\n            \"entityType\": null,\n            \"name\": \"Felipe\",\n            \"email\": \"felipe.brasil@gmail.com\",\n            \"countryCallingCode\": null,\n            \"cellphone\": null,\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2024-03-19T09:19:23-03:00\",\n            \"updatedAt\": \"2024-03-19T09:19:23-03:00\"\n        },\n        {\n            \"id\": 187670,\n            \"entityType\": null,\n            \"name\": \"Guper Teste\",\n            \"email\": \"teste@guper.co\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": null,\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2024-08-26T13:25:28-03:00\",\n            \"updatedAt\": \"2024-08-26T13:25:28-03:00\"\n        },\n        {\n            \"id\": 619,\n            \"entityType\": null,\n            \"name\": \"Carlos\",\n            \"email\": \"carlos@gmail.com\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": \"196654985465\",\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2023-10-17T15:43:26-03:00\",\n            \"updatedAt\": \"2023-10-17T19:09:35-03:00\"\n        },\n        {\n            \"id\": 622,\n            \"entityType\": null,\n            \"name\": \"Daniel Arbelaez\",\n            \"email\": \"daniel.arbelaez@guper.co\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": \"3015315043\",\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2023-10-30T21:59:25-03:00\",\n            \"updatedAt\": \"2023-10-30T21:59:25-03:00\"\n        },\n        {\n            \"id\": 623,\n            \"entityType\": null,\n            \"name\": \"Ingrid Almeida\",\n            \"email\": \"ingrid@guper.co\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": \"5548531717\",\n            \"document\": null,\n            \"gender\": null,\n            \"postalCode\": null,\n            \"dateOfBirth\": null,\n            \"language\": null,\n            \"flags\": null,\n            \"matchWith\": null,\n            \"isHomologation\": 0,\n            \"store\": null,\n            \"createdAt\": \"2023-10-31T23:32:48-03:00\",\n            \"updatedAt\": \"2023-10-31T23:33:28-03:00\"\n        }\n    ],\n    \"total\": 6,\n    \"pagination\": {\n        \"entries\": 100,\n        \"order\": [],\n        \"totalPages\": 1,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": true,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 0\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Remove person",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person"
                            ]
                        },
                        "description": "Soft-deletes a person record (the model uses the standard `Tools\\Data\\Delete`\nflow which marks the row as removed). The ID goes in the request body, not in\nthe URL.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 1\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Person removed.",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person"
                                    ]
                                },
                                "description": "Soft-deletes a person record (the model uses the standard `Tools\\Data\\Delete`\nflow which marks the row as removed). The ID goes in the request body, not in\nthe URL.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Update person",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person"
                            ]
                        },
                        "description": "Updates a record in `register.person`. Only `id` is required; any other field\npresent in the body is updated, anything omitted is left untouched. Same\nsanitization as the create endpoint (phone via libphonenumber, email\nlower-cased, document stripped to alphanumeric).",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"id\": 1,\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintin@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Person updated.",
                            "originalRequest": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person"
                                    ]
                                },
                                "description": "Updates a record in `register.person`. Only `id` is required; any other field\npresent in the body is updated, anything omitted is left untouched. Same\nsanitization as the create endpoint (phone via libphonenumber, email\nlower-cased, document stripped to alphanumeric).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"name\": \"Tintin\",\n    \"entityType\": \"individual\",\n    \"document\": \"32165987\",\n    \"email\": \"tintin@guper.co\",\n    \"countryCallingCode\": 55,\n    \"cellphone\": \"19982456598\",\n    \"dateOfBirth\": \"1989-03-29\",\n    \"postalCode\": \"13450000\",\n    \"gender\": \"male\",\n    \"language\": \"pt_BR\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Ping",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "x-guper-authorization",
                        "value": "{{x-guper-authorization}}",
                        "type": "text",
                        "description": "User token issued by Guper."
                    },
                    {
                        "key": "Content-Type",
                        "value": "{{Content-Type}}",
                        "type": "text",
                        "description": "Always `application/json` for endpoints that accept a JSON body."
                    }
                ],
                "url": {
                    "raw": "https://{{organization}}.myguper.com/api/register/ping",
                    "protocol": "https",
                    "host": [
                        "{{organization}}",
                        "myguper",
                        "com"
                    ],
                    "path": [
                        "api",
                        "register",
                        "ping"
                    ]
                },
                "description": "Resource for checking service availability"
            },
            "response": [
                {
                    "name": "Success",
                    "originalRequest": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/ping",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "ping"
                            ]
                        },
                        "description": "Resource for checking service availability"
                    },
                    "status": "OK",
                    "code": 200,
                    "_postman_previewlanguage": "json",
                    "header": [
                        {
                            "key": "Content-Type",
                            "value": "application/json"
                        }
                    ],
                    "body": "{\n    \"account\": \"acme\",\n    \"response\": \"Server online\",\n    \"dateTime\": \"2023-08-11T13:48:50-03:00\"\n}"
                }
            ]
        },
        {
            "name": "Report",
            "item": [
                {
                    "name": "NPS / CSAT by store — customer satisfaction & reviews",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/report/feedbackNps",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "report",
                                "feedbackNps"
                            ]
                        },
                        "description": "Consolidated **customer satisfaction** report — NPS, CSAT, the ratings and\nreviews customers leave — the answer to \"what's our NPS\", \"satisfaction per\nstore\", \"how are customers rating us\", \"which stores score best\", in a\n**single call**. No need to page the feedback reviews store by store. (For the\nraw responses one by one, use the feedback review list.)\n\nReturns the overall total and a per-store breakdown, with `responses`,\n`avgRating`, and how many reviews came in without a salesperson\n(`withoutSalesperson`, typically e-commerce).\n\nThe rest depends on `type`:\n\n- **`type=nps`** (0-10 scale): `promoters` (9-10), `passives` (7-8),\n  `detractors` (0-6) and the computed `nps = (promoters − detractors) /\n  responses × 100`.\n- **`type=csat`** (1-5 scale): `satisfied` (4-5), `neutral` (3),\n  `unsatisfied` (1-2) and `satisfactionRate = satisfied / responses` (a ratio,\n  `0.967` = 96.7%). The NPS fields are **not** emitted for CSAT — a 1-5 rating is\n  never a \"detractor\" on the 0-10 band, so an NPS score there is meaningless."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/feedbackNps",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "feedbackNps"
                                    ]
                                },
                                "description": "Consolidated **customer satisfaction** report — NPS, CSAT, the ratings and\nreviews customers leave — the answer to \"what's our NPS\", \"satisfaction per\nstore\", \"how are customers rating us\", \"which stores score best\", in a\n**single call**. No need to page the feedback reviews store by store. (For the\nraw responses one by one, use the feedback review list.)\n\nReturns the overall total and a per-store breakdown, with `responses`,\n`avgRating`, and how many reviews came in without a salesperson\n(`withoutSalesperson`, typically e-commerce).\n\nThe rest depends on `type`:\n\n- **`type=nps`** (0-10 scale): `promoters` (9-10), `passives` (7-8),\n  `detractors` (0-6) and the computed `nps = (promoters − detractors) /\n  responses × 100`.\n- **`type=csat`** (1-5 scale): `satisfied` (4-5), `neutral` (3),\n  `unsatisfied` (1-2) and `satisfactionRate = satisfied / responses` (a ratio,\n  `0.967` = 96.7%). The NPS fields are **not** emitted for CSAT — a 1-5 rating is\n  never a \"detractor\" on the 0-10 band, so an NPS score there is meaningless."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"type\": \"nps\", \"period\": { \"start\": \"2026-06-11\", \"end\": \"2026-09-09\" }, \"store\": null },\n  \"total\": {\n    \"stores\": 58, \"responses\": 3753,\n    \"promoters\": 3637, \"passives\": 75, \"detractors\": 41,\n    \"nps\": 95.8, \"avgRating\": 9.82,\n    \"withoutSalesperson\": 1136, \"withoutSalespersonPct\": 0.3027\n  },\n  \"byStore\": [\n    { \"storeId\": 40,  \"store\": \"ECOMMERCE\",            \"responses\": 478, \"promoters\": 459, \"passives\": 7, \"detractors\": 12, \"nps\": 93.5, \"avgRating\": 9.73, \"withoutSalesperson\": 478, \"withoutSalespersonPct\": 1 },\n    { \"storeId\": 155, \"store\": \"CC MERIDA ALTABRISA\",  \"responses\": 195, \"promoters\": 191, \"passives\": 4, \"detractors\": 0,  \"nps\": 97.9, \"avgRating\": 9.90, \"withoutSalesperson\": 34,  \"withoutSalespersonPct\": 0.1744 },\n    { \"storeId\": 138, \"store\": \"CC MERIDA GALERIAS\",   \"responses\": 162, \"promoters\": 161, \"passives\": 1, \"detractors\": 0,  \"nps\": 99.4, \"avgRating\": 9.90, \"withoutSalesperson\": 25,  \"withoutSalespersonPct\": 0.1543 }\n  ]\n}"
                        },
                        {
                            "name": "OK — `type=csat`",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/feedbackNps",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "feedbackNps"
                                    ]
                                },
                                "description": "Consolidated **customer satisfaction** report — NPS, CSAT, the ratings and\nreviews customers leave — the answer to \"what's our NPS\", \"satisfaction per\nstore\", \"how are customers rating us\", \"which stores score best\", in a\n**single call**. No need to page the feedback reviews store by store. (For the\nraw responses one by one, use the feedback review list.)\n\nReturns the overall total and a per-store breakdown, with `responses`,\n`avgRating`, and how many reviews came in without a salesperson\n(`withoutSalesperson`, typically e-commerce).\n\nThe rest depends on `type`:\n\n- **`type=nps`** (0-10 scale): `promoters` (9-10), `passives` (7-8),\n  `detractors` (0-6) and the computed `nps = (promoters − detractors) /\n  responses × 100`.\n- **`type=csat`** (1-5 scale): `satisfied` (4-5), `neutral` (3),\n  `unsatisfied` (1-2) and `satisfactionRate = satisfied / responses` (a ratio,\n  `0.967` = 96.7%). The NPS fields are **not** emitted for CSAT — a 1-5 rating is\n  never a \"detractor\" on the 0-10 band, so an NPS score there is meaningless."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"type\": \"csat\", \"period\": { \"start\": \"2026-07-01\", \"end\": \"2026-09-30\" }, \"store\": null },\n  \"total\": {\n    \"stores\": 55, \"responses\": 3006,\n    \"satisfied\": 2908, \"neutral\": 65, \"unsatisfied\": 33,\n    \"satisfactionRate\": 0.9674, \"avgRating\": 4.85,\n    \"withoutSalesperson\": 378, \"withoutSalespersonPct\": 0.1257\n  },\n  \"byStore\": [ { \"storeId\": 40, \"store\": \"ECOMMERCE\", \"responses\": 230, \"satisfied\": 222, \"neutral\": 5, \"unsatisfied\": 3, \"satisfactionRate\": 0.9652, \"avgRating\": 4.83, \"withoutSalesperson\": 230, \"withoutSalespersonPct\": 1 } ]\n}"
                        },
                        {
                            "name": "OK — `groupBy=month`",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/feedbackNps",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "feedbackNps"
                                    ]
                                },
                                "description": "Consolidated **customer satisfaction** report — NPS, CSAT, the ratings and\nreviews customers leave — the answer to \"what's our NPS\", \"satisfaction per\nstore\", \"how are customers rating us\", \"which stores score best\", in a\n**single call**. No need to page the feedback reviews store by store. (For the\nraw responses one by one, use the feedback review list.)\n\nReturns the overall total and a per-store breakdown, with `responses`,\n`avgRating`, and how many reviews came in without a salesperson\n(`withoutSalesperson`, typically e-commerce).\n\nThe rest depends on `type`:\n\n- **`type=nps`** (0-10 scale): `promoters` (9-10), `passives` (7-8),\n  `detractors` (0-6) and the computed `nps = (promoters − detractors) /\n  responses × 100`.\n- **`type=csat`** (1-5 scale): `satisfied` (4-5), `neutral` (3),\n  `unsatisfied` (1-2) and `satisfactionRate = satisfied / responses` (a ratio,\n  `0.967` = 96.7%). The NPS fields are **not** emitted for CSAT — a 1-5 rating is\n  never a \"detractor\" on the 0-10 band, so an NPS score there is meaningless."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": { \"type\": \"nps\", \"period\": { \"start\": \"2026-07-01\", \"end\": \"2026-09-30\" }, \"timezone\": \"America/Mexico_City\", \"groupBy\": [\"month\"], \"filters\": { \"clients\": null, \"orders\": null } },\n  \"total\": { \"stores\": 60, \"responses\": 3738, \"promoters\": 3625, \"passives\": 72, \"detractors\": 41, \"nps\": 95.9, \"avgRating\": 9.82, \"withoutSalesperson\": 836, \"withoutSalespersonPct\": 0.2237 },\n  \"rows\": [\n    { \"month\": \"2026-08\", \"responses\": 1668, \"promoters\": 1620, \"passives\": 35, \"detractors\": 13, \"nps\": 96.4, \"avgRating\": 9.83, \"withoutSalesperson\": 316, \"withoutSalespersonPct\": 0.1894 },\n    { \"month\": \"2026-07\", \"responses\": 1223, \"promoters\": 1182, \"passives\": 23, \"detractors\": 18, \"nps\": 95.2, \"avgRating\": 9.80, \"withoutSalesperson\": 300, \"withoutSalespersonPct\": 0.2453 },\n    { \"month\": \"2026-09\", \"responses\": 847,  \"promoters\": 823,  \"passives\": 14, \"detractors\": 10, \"nps\": 96.3, \"avgRating\": 9.84, \"withoutSalesperson\": 220, \"withoutSalespersonPct\": 0.2597 }\n  ]\n}"
                        },
                        {
                            "name": "Invalid `type` or `groupBy`, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/feedbackNps",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "feedbackNps"
                                    ]
                                },
                                "description": "Consolidated **customer satisfaction** report — NPS, CSAT, the ratings and\nreviews customers leave — the answer to \"what's our NPS\", \"satisfaction per\nstore\", \"how are customers rating us\", \"which stores score best\", in a\n**single call**. No need to page the feedback reviews store by store. (For the\nraw responses one by one, use the feedback review list.)\n\nReturns the overall total and a per-store breakdown, with `responses`,\n`avgRating`, and how many reviews came in without a salesperson\n(`withoutSalesperson`, typically e-commerce).\n\nThe rest depends on `type`:\n\n- **`type=nps`** (0-10 scale): `promoters` (9-10), `passives` (7-8),\n  `detractors` (0-6) and the computed `nps = (promoters − detractors) /\n  responses × 100`.\n- **`type=csat`** (1-5 scale): `satisfied` (4-5), `neutral` (3),\n  `unsatisfied` (1-2) and `satisfactionRate = satisfied / responses` (a ratio,\n  `0.967` = 96.7%). The NPS fields are **not** emitted for CSAT — a 1-5 rating is\n  never a \"detractor\" on the 0-10 band, so an NPS score there is meaningless."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Program members / associates report",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/report/members",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "report",
                                "members"
                            ]
                        },
                        "description": "Who the **members / associates** of a loyalty program are, org-wide, in a\n**single call** — how many there are, their tier and source mix, how many have\never bought, and what they are worth over their lifetime. The answer to \"how\nmany associates do we have\", \"how many members converted into buyers\", \"what is\nthe member base\".\n\nGeneric: parameterized by `tierConfig` (any org's program). It is **register-only**\n— built from `person_membership` + `person_tier` + `person_rfm`, no call to the\norder service. `total` carries `members` (active), `buyersLifetime`,\n`conversionLifetime` and `lifetimeValue`; `byTier`, `bySource` and `byMonth`\n(member growth) break it down.\n\nRead the lens carefully:\n- **`conversionLifetime`** = members who have **ever** bought (`person_rfm`) — it is\n  **lifetime**, NOT conversion in a period.\n- **`lifetimeValue`** = the members' total lifetime spend (gross, all stores). Values\n  in **cents**. It is **not** revenue in a period.\n- **`meta.membershipStartedAt`** = the first month with a join. Before that there are\n  no members, so comparing \"revenue from members\" against a long period must stay\n  inside the window that has membership.\n\nNot here on purpose: **revenue from members in a period** — that belongs to the order\nservice (`total_order` cut by date), via `order.report.sales` and the\n`order_personMembership` snapshot (which exists only from ~2026-05-28). This report\nis the lifetime/structural view of the member base."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/members",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "members"
                                    ]
                                },
                                "description": "Who the **members / associates** of a loyalty program are, org-wide, in a\n**single call** — how many there are, their tier and source mix, how many have\never bought, and what they are worth over their lifetime. The answer to \"how\nmany associates do we have\", \"how many members converted into buyers\", \"what is\nthe member base\".\n\nGeneric: parameterized by `tierConfig` (any org's program). It is **register-only**\n— built from `person_membership` + `person_tier` + `person_rfm`, no call to the\norder service. `total` carries `members` (active), `buyersLifetime`,\n`conversionLifetime` and `lifetimeValue`; `byTier`, `bySource` and `byMonth`\n(member growth) break it down.\n\nRead the lens carefully:\n- **`conversionLifetime`** = members who have **ever** bought (`person_rfm`) — it is\n  **lifetime**, NOT conversion in a period.\n- **`lifetimeValue`** = the members' total lifetime spend (gross, all stores). Values\n  in **cents**. It is **not** revenue in a period.\n- **`meta.membershipStartedAt`** = the first month with a join. Before that there are\n  no members, so comparing \"revenue from members\" against a long period must stay\n  inside the window that has membership.\n\nNot here on purpose: **revenue from members in a period** — that belongs to the order\nservice (`total_order` cut by date), via `order.report.sales` and the\n`order_personMembership` snapshot (which exists only from ~2026-05-28). This report\nis the lifetime/structural view of the member base."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": {\n    \"tierConfig\": 1, \"program\": \"The program's name\",\n    \"membershipStartedAt\": \"2026-03\", \"unit\": \"cents\"\n  },\n  \"total\": {\n    \"members\": 717, \"buyersLifetime\": 453, \"conversionLifetime\": 0.6318,\n    \"lifetimeValue\": 130439911, \"avgLifetimeValue\": 181925\n  },\n  \"byTier\": [\n    { \"levelId\": 1, \"levelName\": \"Entry\", \"members\": 618 },\n    { \"levelId\": 2, \"levelName\": \"Mid\",   \"members\": 78 }\n  ],\n  \"bySource\": [\n    { \"source\": \"optin_hook\", \"members\": 419 },\n    { \"source\": \"backfill\",   \"members\": 298 }\n  ],\n  \"byMonth\": [\n    { \"month\": \"2026-03\", \"joined\": 95, \"left\": 0, \"activeEnd\": 95 },\n    { \"month\": \"2026-04\", \"joined\": 107, \"left\": 0, \"activeEnd\": 202 }\n  ]\n}"
                        },
                        {
                            "name": "Org has no program, or has more than one and `tierConfig` was not given, or the given `tierConfig` is invalid.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/members",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "members"
                                    ]
                                },
                                "description": "Who the **members / associates** of a loyalty program are, org-wide, in a\n**single call** — how many there are, their tier and source mix, how many have\never bought, and what they are worth over their lifetime. The answer to \"how\nmany associates do we have\", \"how many members converted into buyers\", \"what is\nthe member base\".\n\nGeneric: parameterized by `tierConfig` (any org's program). It is **register-only**\n— built from `person_membership` + `person_tier` + `person_rfm`, no call to the\norder service. `total` carries `members` (active), `buyersLifetime`,\n`conversionLifetime` and `lifetimeValue`; `byTier`, `bySource` and `byMonth`\n(member growth) break it down.\n\nRead the lens carefully:\n- **`conversionLifetime`** = members who have **ever** bought (`person_rfm`) — it is\n  **lifetime**, NOT conversion in a period.\n- **`lifetimeValue`** = the members' total lifetime spend (gross, all stores). Values\n  in **cents**. It is **not** revenue in a period.\n- **`meta.membershipStartedAt`** = the first month with a join. Before that there are\n  no members, so comparing \"revenue from members\" against a long period must stay\n  inside the window that has membership.\n\nNot here on purpose: **revenue from members in a period** — that belongs to the order\nservice (`total_order` cut by date), via `order.report.sales` and the\n`order_personMembership` snapshot (which exists only from ~2026-05-28). This report\nis the lifetime/structural view of the member base."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                },
                {
                    "name": "Customer RFM by acquisition cohort — new customers / sign-ups per day",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/report/rfm-cohort/{{dateStart}}/{{dateEnd}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "report",
                                "rfm-cohort",
                                "{{dateStart}}",
                                "{{dateEnd}}"
                            ]
                        },
                        "description": "Customer RFM aggregated by **acquisition cohort** — how many customers were\nacquired in each month (or at each store), and what they are worth over their\nlifetime — in a **single call**. It is the RFM base, grouped: instead of\npaging ~hundreds of thousands of per-customer rows and grouping client-side,\nthis returns the cohort rollup at once.\n\nA cohort is cut by the **first-purchase date** (`firstPurchaseDate`). Group by\n`month` (acquisition month), `firstStore` (acquisition store), or both. Per\ncohort you get `clients`, `lifetimeValue` and `avgValue` (spend), `avgOrders`\n(frequency), `avgCadenceDays` (repeat interval, only over customers with 2+\norders) and `avgDaysWithoutPurchase` (recency today).\n\nValues are in **cents**. The month is cut in the organization timezone, so\ncohorts line up with the sales report by (month, store). `total` reconciles\nwith the sum of the rows by construction.\n\nRead the semantics carefully: **store is the acquisition store** and\n**`lifetimeValue` is the customer's org-wide lifetime spend** (across every\nstore), not the store's sales — \"customers acquired at store X and what they\nspent everywhere\". For store sales use `order.report.sales`; do not mix them."
                    },
                    "response": [
                        {
                            "name": "OK — with `groupBy=month`",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/rfm-cohort/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "rfm-cohort",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Customer RFM aggregated by **acquisition cohort** — how many customers were\nacquired in each month (or at each store), and what they are worth over their\nlifetime — in a **single call**. It is the RFM base, grouped: instead of\npaging ~hundreds of thousands of per-customer rows and grouping client-side,\nthis returns the cohort rollup at once.\n\nA cohort is cut by the **first-purchase date** (`firstPurchaseDate`). Group by\n`month` (acquisition month), `firstStore` (acquisition store), or both. Per\ncohort you get `clients`, `lifetimeValue` and `avgValue` (spend), `avgOrders`\n(frequency), `avgCadenceDays` (repeat interval, only over customers with 2+\norders) and `avgDaysWithoutPurchase` (recency today).\n\nValues are in **cents**. The month is cut in the organization timezone, so\ncohorts line up with the sales report by (month, store). `total` reconciles\nwith the sum of the rows by construction.\n\nRead the semantics carefully: **store is the acquisition store** and\n**`lifetimeValue` is the customer's org-wide lifetime spend** (across every\nstore), not the store's sales — \"customers acquired at store X and what they\nspent everywhere\". For store sales use `order.report.sales`; do not mix them."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n  \"meta\": {\n    \"unit\": \"cents\", \"timezone\": \"Etc/GMT+6\",\n    \"groupBy\": [\"month\"],\n    \"window\": { \"dateStart\": \"2025-01-01\", \"dateEnd\": \"2025-06-30\" }\n  },\n  \"rows\": [\n    { \"month\": \"2025-01\", \"clients\": 16131, \"lifetimeValue\": 4676422124, \"avgValue\": 289903,\n      \"avgOrders\": 1.50, \"avgCadenceDays\": 98.1, \"avgDaysWithoutPurchase\": 435 },\n    { \"month\": \"2025-02\", \"clients\": 8890, \"lifetimeValue\": 2766238779, \"avgValue\": 311163,\n      \"avgOrders\": 1.49, \"avgCadenceDays\": 94.2, \"avgDaysWithoutPurchase\": 410 }\n  ],\n  \"total\": {\n    \"clients\": 74775, \"lifetimeValue\": 24488794816, \"avgValue\": 327500,\n    \"avgOrders\": 2.49, \"avgCadenceDays\": 78, \"avgDaysWithoutPurchase\": 366\n  }\n}"
                        },
                        {
                            "name": "Invalid `groupBy`, or `dateStart` after `dateEnd`.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/report/rfm-cohort/{{dateStart}}/{{dateEnd}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "report",
                                        "rfm-cohort",
                                        "{{dateStart}}",
                                        "{{dateEnd}}"
                                    ]
                                },
                                "description": "Customer RFM aggregated by **acquisition cohort** — how many customers were\nacquired in each month (or at each store), and what they are worth over their\nlifetime — in a **single call**. It is the RFM base, grouped: instead of\npaging ~hundreds of thousands of per-customer rows and grouping client-side,\nthis returns the cohort rollup at once.\n\nA cohort is cut by the **first-purchase date** (`firstPurchaseDate`). Group by\n`month` (acquisition month), `firstStore` (acquisition store), or both. Per\ncohort you get `clients`, `lifetimeValue` and `avgValue` (spend), `avgOrders`\n(frequency), `avgCadenceDays` (repeat interval, only over customers with 2+\norders) and `avgDaysWithoutPurchase` (recency today).\n\nValues are in **cents**. The month is cut in the organization timezone, so\ncohorts line up with the sales report by (month, store). `total` reconciles\nwith the sum of the rows by construction.\n\nRead the semantics carefully: **store is the acquisition store** and\n**`lifetimeValue` is the customer's org-wide lifetime spend** (across every\nstore), not the store's sales — \"customers acquired at store X and what they\nspent everywhere\". For store sales use `order.report.sales`; do not mix them."
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": ""
                        }
                    ]
                }
            ]
        },
        {
            "name": "Segmentation",
            "item": [
                {
                    "name": "Tags",
                    "item": [
                        {
                            "name": "Create segmentation tag",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tags",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tags"
                                    ]
                                },
                                "description": "Creates a tag in the organization's segmentation taxonomy. Tags belong to a\n`category` (which itself has a `type` — `tier`, `behavior`, `customerTag`, …\n— that decides which manager handles the tag). The endpoint dispatches to the\nmatching `Segmentation\\Manager` based on the resolved category type, defaulting\nto the *Standard* manager when no special handler is registered.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"VIP\",\n    \"category\": 7,\n    \"priority\": 100,\n    \"data\": {\n        \"color\": \"#FFD700\"\n    }\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Tag created.",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tags",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tags"
                                            ]
                                        },
                                        "description": "Creates a tag in the organization's segmentation taxonomy. Tags belong to a\n`category` (which itself has a `type` — `tier`, `behavior`, `customerTag`, …\n— that decides which manager handles the tag). The endpoint dispatches to the\nmatching `Segmentation\\Manager` based on the resolved category type, defaulting\nto the *Standard* manager when no special handler is registered.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"VIP\",\n    \"category\": 7,\n    \"priority\": 100,\n    \"data\": {\n        \"color\": \"#FFD700\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 42,\n    \"name\": \"VIP\",\n    \"type\": null,\n    \"category\": 7,\n    \"priority\": 100,\n    \"data\": { \"color\": \"#FFD700\" }\n}"
                                }
                            ]
                        },
                        {
                            "name": "List Tags",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tags",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tags"
                                    ]
                                },
                                "description": "Returns a paginated list of resources."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tags",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tags"
                                            ]
                                        },
                                        "description": "Returns a paginated list of resources."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Stores",
            "item": [
                {
                    "name": "Store",
                    "item": [
                        {
                            "name": "Create Store",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store"
                                    ]
                                },
                                "description": "Cria uma loja na organização. `name` é o único campo obrigatório.\n\n`interface` + `refId` formam o par usado pelo middleware para resolver\na loja a partir de IDs externos (VTEX, ERP etc.).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Loja 3\",\n    \"refId\": \"L-003\",\n    \"interface\": \"vtex\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store"
                                            ]
                                        },
                                        "description": "Cria uma loja na organização. `name` é o único campo obrigatório.\n\n`interface` + `refId` formam o par usado pelo middleware para resolver\na loja a partir de IDs externos (VTEX, ERP etc.).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Loja 3\",\n    \"refId\": \"L-003\",\n    \"interface\": \"vtex\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 22,\n    \"name\": \"Loja 3\",\n    \"refId\": \"L-003\",\n    \"interface\": \"vtex\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "List Stores",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store"
                                    ]
                                },
                                "description": "Returns a paginated list of resources."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store"
                                            ]
                                        },
                                        "description": "Returns a paginated list of resources."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Load",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a store's details by internal ID."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a store's details by internal ID."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 194,\n    \"refId\": \"2\",\n    \"name\": \"UNNAMED - 2\",\n    \"interface\": \"\",\n    \"policie\": [\n        14,\n        15\n    ],\n    \"policy\": [\n        14,\n        15\n    ],\n    \"channels\": [\n        23\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Store",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store"
                                    ]
                                },
                                "description": "Remove uma loja. Falha se ainda existirem links de carteira ou de\ngrupo de lojas apontando para ela — apague esses vínculos antes\n(`/store/walletLink` e `/linkStoreGroup`).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store"
                                            ]
                                        },
                                        "description": "Remove uma loja. Falha se ainda existirem links de carteira ou de\ngrupo de lojas apontando para ela — apague esses vínculos antes\n(`/store/walletLink` e `/linkStoreGroup`).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        },
                        {
                            "name": "Update Store",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store"
                                    ]
                                },
                                "description": "Atualiza uma loja. Envie apenas os campos que mudam — `id` é obrigatório.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 22,\n    \"name\": \"Loja 1\",\n    \"refId\": \"L-001\",\n    \"interface\": \"vtex\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store"
                                            ]
                                        },
                                        "description": "Atualiza uma loja. Envie apenas os campos que mudam — `id` é obrigatório.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 22,\n    \"name\": \"Loja 1\",\n    \"refId\": \"L-001\",\n    \"interface\": \"vtex\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Store By",
                    "item": [
                        {
                            "name": "Interface And RefId",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/by/interface/{{interface}}/refId/{{refId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "by",
                                        "interface",
                                        "{{interface}}",
                                        "refId",
                                        "{{refId}}"
                                    ]
                                },
                                "description": "Returns a store's details using its external `interface` + `refId` instead of the internal ID."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/by/interface/{{interface}}/refId/{{refId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "by",
                                                "interface",
                                                "{{interface}}",
                                                "refId",
                                                "{{refId}}"
                                            ]
                                        },
                                        "description": "Returns a store's details using its external `interface` + `refId` instead of the internal ID."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Store Group",
                    "item": [
                        {
                            "name": "Create Store Group",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "storeGroup"
                                    ]
                                },
                                "description": "Cria um grupo de lojas (`storeGroup`). Grupos são usados para\norganizar lojas por região, canal ou bandeira, e para vincular regras\nde loyalty/cashback a múltiplas lojas de uma vez.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Região Sul\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "storeGroup"
                                            ]
                                        },
                                        "description": "Cria um grupo de lojas (`storeGroup`). Grupos são usados para\norganizar lojas por região, canal ou bandeira, e para vincular regras\nde loyalty/cashback a múltiplas lojas de uma vez.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Região Sul\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"name\": \"Região Sul\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "List Store Groups",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "storeGroup"
                                    ]
                                },
                                "description": "Request for registering people"
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "storeGroup"
                                            ]
                                        },
                                        "description": "Request for registering people"
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Load",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/storeGroup/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "storeGroup",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Carrega um grupo de lojas pelo seu `id`. Retorna apenas os campos\nbásicos do grupo (id e nome) — para listar os links com lojas, use\n`GET /api/register/linkStoreGroup`."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/storeGroup/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "storeGroup",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Carrega um grupo de lojas pelo seu `id`. Retorna apenas os campos\nbásicos do grupo (id e nome) — para listar os links com lojas, use\n`GET /api/register/linkStoreGroup`."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 1,\n    \"name\": \"Região Sul\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Remove Store Group",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "storeGroup"
                                    ]
                                },
                                "description": "Remove um grupo de lojas. Falha se ainda existirem lojas vinculadas\n— desvincule pelo `/linkStoreGroup` antes.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "storeGroup"
                                            ]
                                        },
                                        "description": "Remove um grupo de lojas. Falha se ainda existirem lojas vinculadas\n— desvincule pelo `/linkStoreGroup` antes.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        },
                        {
                            "name": "Update Store Group",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "storeGroup"
                                    ]
                                },
                                "description": "Atualiza um grupo de lojas. `id` é obrigatório.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 1,\n    \"name\": \"Região Leste\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/storeGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "storeGroup"
                                            ]
                                        },
                                        "description": "Atualiza um grupo de lojas. `id` é obrigatório.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 1,\n    \"name\": \"Região Leste\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Store Wallet Link",
                    "item": [
                        {
                            "name": "Create store ↔ policy link",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "walletLink"
                                    ]
                                },
                                "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nCreates **one** link. To set every store of a policy at once, use [Sync store ↔ policy links](/docs/{lang}/api-reference/register/stores/store-wallet-link/sync).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nCreates **one** link. To set every store of a policy at once, use [Sync store ↔ policy links](/docs/{lang}/api-reference/register/stores/store-wallet-link/sync).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"store\": 22,\n    \"wallet\": 108,\n    \"organization\": \"acme\",\n    \"dateTime\": \"2026-10-03T10:15:00-03:00\"\n}"
                                },
                                {
                                    "name": "Link already exists or store does not exist",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nCreates **one** link. To set every store of a policy at once, use [Sync store ↔ policy links](/docs/{lang}/api-reference/register/stores/store-wallet-link/sync).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 418,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"message\": \"Unable to process this record\" }"
                                }
                            ]
                        },
                        {
                            "name": "Delete store ↔ policy link",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "walletLink"
                                    ]
                                },
                                "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nRemoves **one** link, identified by the `(store, wallet)` pair. From then on the policy no longer applies at that store.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nRemoves **one** link, identified by the `(store, wallet)` pair. From then on the policy no longer applies at that store.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"store\": 22, \"wallet\": 108, \"dateTime\": \"2026-10-03T10:15:00-03:00\" }"
                                },
                                {
                                    "name": "Link not found",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nRemoves **one** link, identified by the `(store, wallet)` pair. From then on the policy no longer applies at that store.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 22,\n    \"wallet\": 108\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 418,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"message\": \"It is not possible to delete this register\" }"
                                }
                            ]
                        },
                        {
                            "name": "List store ↔ policy links",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "walletLink"
                                    ]
                                },
                                "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nLists the links. Filter by one side with `q[wallet]=108` (stores of a policy) or `q[store]=22` (policies of a store). Send `with=store` to get each store as an object (`id`, `name`, `refId`, `interface`) instead of the id.\n\nHow the policies are applied to an order (cap, aggregation mode and the competition\nbetween policies), with examples: [Redemption policies](/docs/{lang}/guides/redemption-policies)."
                            },
                            "response": [
                                {
                                    "name": "OK (with=store)",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nLists the links. Filter by one side with `q[wallet]=108` (stores of a policy) or `q[store]=22` (policies of a store). Send `with=store` to get each store as an object (`id`, `name`, `refId`, `interface`) instead of the id.\n\nHow the policies are applied to an order (cap, aggregation mode and the competition\nbetween policies), with examples: [Redemption policies](/docs/{lang}/guides/redemption-policies)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"list\": [\n        {\n            \"store\": { \"id\": 22, \"name\": \"Boutique Centro\", \"refId\": \"BTQ01\", \"interface\": \"zoku\" },\n            \"wallet\": 108\n        }\n    ],\n    \"total\": 1,\n    \"pagination\": {\n        \"entries\": 0,\n        \"order\": [],\n        \"totalPages\": 1,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": true,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 0\n    }\n}"
                                }
                            ]
                        },
                        {
                            "name": "Sync store ↔ policy links",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "store",
                                        "walletLink"
                                    ]
                                },
                                "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nSets **all** the links of one side at once, in a single transaction. Anchor one side and send the\n**complete** list of the other:\n\n- `{\"wallet\": 108, \"stores\": [22, 23, 41]}` — the policy will apply exactly at these stores.\n- `{\"store\": 22, \"wallets\": [108, 109]}` — exactly these policies will apply at this store.\n\nThe list is the **final state**, not an increment: links missing from it are removed, and an\n**empty list removes every link** of the anchor. Invalid ids (`0`, negative, non-numeric) are\nignored, and repeated ids are merged. Sending the same body twice gives the same result.\n\nIf any store does not exist in the organization, nothing is changed and the response is `422`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"wallet\": 108,\n    \"stores\": [\n        22,\n        23,\n        41\n    ],\n    \"store\": null,\n    \"wallets\": null\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nSets **all** the links of one side at once, in a single transaction. Anchor one side and send the\n**complete** list of the other:\n\n- `{\"wallet\": 108, \"stores\": [22, 23, 41]}` — the policy will apply exactly at these stores.\n- `{\"store\": 22, \"wallets\": [108, 109]}` — exactly these policies will apply at this store.\n\nThe list is the **final state**, not an increment: links missing from it are removed, and an\n**empty list removes every link** of the anchor. Invalid ids (`0`, negative, non-numeric) are\nignored, and repeated ids are merged. Sending the same body twice gives the same result.\n\nIf any store does not exist in the organization, nothing is changed and the response is `422`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"wallet\": 108,\n    \"stores\": [\n        22,\n        23,\n        41\n    ],\n    \"store\": null,\n    \"wallets\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"organization\": \"acme\",\n    \"wallet\": 108,\n    \"linked\": [22, 23, 41],\n    \"created\": 1,\n    \"removed\": 2\n}"
                                },
                                {
                                    "name": "Neither form of the body was sent",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nSets **all** the links of one side at once, in a single transaction. Anchor one side and send the\n**complete** list of the other:\n\n- `{\"wallet\": 108, \"stores\": [22, 23, 41]}` — the policy will apply exactly at these stores.\n- `{\"store\": 22, \"wallets\": [108, 109]}` — exactly these policies will apply at this store.\n\nThe list is the **final state**, not an increment: links missing from it are removed, and an\n**empty list removes every link** of the anchor. Invalid ids (`0`, negative, non-numeric) are\nignored, and repeated ids are merged. Sending the same body twice gives the same result.\n\nIf any store does not exist in the organization, nothing is changed and the response is `422`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"wallet\": 108,\n    \"stores\": [\n        22,\n        23,\n        41\n    ],\n    \"store\": null,\n    \"wallets\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"message\": \"Json parameters are missing: ( wallet, stores ) or ( store, wallets )\" }"
                                },
                                {
                                    "name": "A store does not exist in the organization",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/store/walletLink",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "store",
                                                "walletLink"
                                            ]
                                        },
                                        "description": "A redemption policy only applies at the stores linked to it. Each link is a `(store, wallet)` pair, where `wallet` is the policy id.\n\nSets **all** the links of one side at once, in a single transaction. Anchor one side and send the\n**complete** list of the other:\n\n- `{\"wallet\": 108, \"stores\": [22, 23, 41]}` — the policy will apply exactly at these stores.\n- `{\"store\": 22, \"wallets\": [108, 109]}` — exactly these policies will apply at this store.\n\nThe list is the **final state**, not an increment: links missing from it are removed, and an\n**empty list removes every link** of the anchor. Invalid ids (`0`, negative, non-numeric) are\nignored, and repeated ids are merged. Sending the same body twice gives the same result.\n\nIf any store does not exist in the organization, nothing is changed and the response is `422`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"wallet\": 108,\n    \"stores\": [\n        22,\n        23,\n        41\n    ],\n    \"store\": null,\n    \"wallets\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"message\": \"store(s) inexistente(s) nesta organizacao: 999\" }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Stores StoreGroups Link",
                    "item": [
                        {
                            "name": "Link Store to Group",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "linkStoreGroup"
                                    ]
                                },
                                "description": "Liga uma loja a um grupo de lojas (`storeGroup`). A presença do par\n`(store, storeGroup)` na tabela `store_storeGroup` é o que faz a\nloja participar do grupo (canal/região/bandeira).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"store\": 1,\n    \"storeGroup\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "linkStoreGroup"
                                            ]
                                        },
                                        "description": "Liga uma loja a um grupo de lojas (`storeGroup`). A presença do par\n`(store, storeGroup)` na tabela `store_storeGroup` é o que faz a\nloja participar do grupo (canal/região/bandeira).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 1,\n    \"storeGroup\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"store\": 1,\n    \"storeGroup\": 1,\n    \"organization\": \"acme\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Unlink Store from Group",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "linkStoreGroup"
                                    ]
                                },
                                "description": "Remove o vínculo loja↔grupo. Os dois identificadores são obrigatórios\n— a remoção é feita pela chave composta `(store, storeGroup)`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"store\": 1,\n    \"storeGroup\": 1\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "linkStoreGroup"
                                            ]
                                        },
                                        "description": "Remove o vínculo loja↔grupo. Os dois identificadores são obrigatórios\n— a remoção é feita pela chave composta `(store, storeGroup)`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"store\": 1,\n    \"storeGroup\": 1\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        },
                        {
                            "name": "List Store-Group Links",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "linkStoreGroup"
                                    ]
                                },
                                "description": "Returns a paginated list of resources."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/linkStoreGroup",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "linkStoreGroup"
                                            ]
                                        },
                                        "description": "Returns a paginated list of resources."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Team",
            "item": [
                {
                    "name": "Áreas",
                    "item": [
                        {
                            "name": "Create Area",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area"
                                    ]
                                },
                                "description": "Cria uma área no organograma. `name` é o único campo obrigatório.\n\nSe `parentId` for informado, o `CycleGuard` valida que a referência não\ncria ciclo na árvore de áreas e que o pai pertence à mesma organização.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Marketing\",\n    \"parentId\": 1,\n    \"description\": \"Marketing & Growth\",\n    \"data\": {\n        \"color\": \"#ff7a00\"\n    }\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Cria uma área no organograma. `name` é o único campo obrigatório.\n\nSe `parentId` for informado, o `CycleGuard` valida que a referência não\ncria ciclo na árvore de áreas e que o pai pertence à mesma organização.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Marketing\",\n    \"parentId\": 1,\n    \"description\": \"Marketing & Growth\",\n    \"data\": {\n        \"color\": \"#ff7a00\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2,\n    \"parentId\": 1,\n    \"name\": \"Marketing\",\n    \"description\": \"Marketing & Growth\",\n    \"data\": { \"color\": \"#ff7a00\" }\n}"
                                },
                                {
                                    "name": "Cycle / parent inválido",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Cria uma área no organograma. `name` é o único campo obrigatório.\n\nSe `parentId` for informado, o `CycleGuard` valida que a referência não\ncria ciclo na árvore de áreas e que o pai pertence à mesma organização.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Marketing\",\n    \"parentId\": 1,\n    \"description\": \"Marketing & Growth\",\n    \"data\": {\n        \"color\": \"#ff7a00\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"parentId would create a cycle in the area tree\",\n    \"code\": 422\n}"
                                }
                            ]
                        },
                        {
                            "name": "Delete Area",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area"
                                    ]
                                },
                                "description": "Remove uma área. Falha (FK RESTRICT) se houver sub-áreas ou cargos vinculados —\napague-os antes ou mova-os para outra área.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 2\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Remove uma área. Falha (FK RESTRICT) se houver sub-áreas ou cargos vinculados —\napague-os antes ou mova-os para outra área.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 2\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Constraint — sub-áreas ou cargos vinculados",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Remove uma área. Falha (FK RESTRICT) se houver sub-áreas ou cargos vinculados —\napague-os antes ou mova-os para outra área.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 2\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 409,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"Cannot delete or update a parent row: a foreign key constraint fails\",\n    \"code\": 409\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get Area",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single the area matching the given identifier."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single the area matching the given identifier."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2,\n    \"parentId\": 1,\n    \"name\": \"Marketing\",\n    \"description\": \"Marketing & Growth\",\n    \"data\": { \"color\": \"#ff7a00\" },\n    \"createdAt\": \"2026-04-24 10:01:00\",\n    \"updatedAt\": \"2026-04-24 10:01:00\"\n}"
                                },
                                {
                                    "name": "Not Found",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single the area matching the given identifier."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"Not Found\",\n    \"code\": 404\n}"
                                }
                            ]
                        },
                        {
                            "name": "List Areas",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area"
                                    ]
                                },
                                "description": "Lista paginada. Filtros via `q[col][operator]=value` (ver List Query Parameters da collection Guper)."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Lista paginada. Filtros via `q[col][operator]=value` (ver List Query Parameters da collection Guper)."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"list\": [\n        { \"id\": 1, \"parentId\": null, \"name\": \"Diretoria\", \"description\": null, \"data\": null, \"createdAt\": \"2026-04-24 10:00:00\", \"updatedAt\": \"2026-04-24 10:00:00\" },\n        { \"id\": 2, \"parentId\": 1,    \"name\": \"Marketing\", \"description\": null, \"data\": null, \"createdAt\": \"2026-04-24 10:01:00\", \"updatedAt\": \"2026-04-24 10:01:00\" },\n        { \"id\": 3, \"parentId\": 1,    \"name\": \"Comercial\", \"description\": null, \"data\": null, \"createdAt\": \"2026-04-24 10:02:00\", \"updatedAt\": \"2026-04-24 10:02:00\" }\n    ],\n    \"total\": 3,\n    \"page\": 1,\n    \"entries\": 50\n}"
                                }
                            ]
                        },
                        {
                            "name": "Subtree (a partir de uma área)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{id}}/tree",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area",
                                        "{{id}}",
                                        "tree"
                                    ]
                                },
                                "description": "Returns the area subtree rooted at the given area ID — the area itself, its child areas and so on recursively."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{id}}/tree",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "{{id}}",
                                                "tree"
                                            ]
                                        },
                                        "description": "Returns the area subtree rooted at the given area ID — the area itself, its child areas and so on recursively."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 2, \"parentId\": 1, \"name\": \"Marketing\", \"depth\": 0,\n    \"children\": [\n        { \"id\": 4, \"parentId\": 2, \"name\": \"SEO\",         \"depth\": 1, \"children\": [] },\n        { \"id\": 5, \"parentId\": 2, \"name\": \"Performance\", \"depth\": 1, \"children\": [] }\n    ]\n}"
                                }
                            ]
                        },
                        {
                            "name": "Tree (organograma completo)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area/tree",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area",
                                        "tree"
                                    ]
                                },
                                "description": "Retorna todas as raízes e descendentes em formato aninhado, via CTE recursiva\n(MySQL 8). Cada nó traz seus `children` já populados.\n\nSe quiser apenas o sub-tree de uma área específica, use\n`GET /api/register/team/area/{id}/tree`."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/tree",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "tree"
                                            ]
                                        },
                                        "description": "Retorna todas as raízes e descendentes em formato aninhado, via CTE recursiva\n(MySQL 8). Cada nó traz seus `children` já populados.\n\nSe quiser apenas o sub-tree de uma área específica, use\n`GET /api/register/team/area/{id}/tree`."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    {\n        \"id\": 1, \"parentId\": null, \"name\": \"Diretoria\", \"description\": null, \"data\": null, \"depth\": 0,\n        \"children\": [\n            { \"id\": 2, \"parentId\": 1, \"name\": \"Marketing\", \"depth\": 1, \"children\": [\n                { \"id\": 4, \"parentId\": 2, \"name\": \"SEO\",         \"depth\": 2, \"children\": [] },\n                { \"id\": 5, \"parentId\": 2, \"name\": \"Performance\", \"depth\": 2, \"children\": [] }\n            ] },\n            { \"id\": 3, \"parentId\": 1, \"name\": \"Comercial\", \"depth\": 1, \"children\": [] }\n        ]\n    }\n]"
                                }
                            ]
                        },
                        {
                            "name": "Update Area",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area"
                                    ]
                                },
                                "description": "Atualiza uma área. Envie apenas os campos que mudam — `id` é obrigatório.\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado\npara evitar referência circular.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 2,\n    \"name\": \"Marketing Digital\",\n    \"parentId\": 1,\n    \"description\": \"Marketing focado em canais digitais\",\n    \"data\": {\n        \"color\": \"#0a84ff\"\n    }\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Atualiza uma área. Envie apenas os campos que mudam — `id` é obrigatório.\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado\npara evitar referência circular.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 2,\n    \"name\": \"Marketing Digital\",\n    \"parentId\": 1,\n    \"description\": \"Marketing focado em canais digitais\",\n    \"data\": {\n        \"color\": \"#0a84ff\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Cycle / parent inválido",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area"
                                            ]
                                        },
                                        "description": "Atualiza uma área. Envie apenas os campos que mudam — `id` é obrigatório.\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado\npara evitar referência circular.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 2,\n    \"name\": \"Marketing Digital\",\n    \"parentId\": 1,\n    \"description\": \"Marketing focado em canais digitais\",\n    \"data\": {\n        \"color\": \"#0a84ff\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"parentId would create a cycle in the area tree\",\n    \"code\": 422\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "List Team Members",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/team/",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "team"
                            ]
                        },
                        "description": "Lists team members (users and collaborators) with pagination, search, position info and setup status. Uses the standard LliureCore query params convention (`q[col][operator]=value`). Includes computed fields: each member's current position (from team_member/team_position) and setup completion status."
                    },
                    "response": [
                        {
                            "name": "Paginated list with counts and position/setup data.",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team"
                                    ]
                                },
                                "description": "Lists team members (users and collaborators) with pagination, search, position info and setup status. Uses the standard LliureCore query params convention (`q[col][operator]=value`). Includes computed fields: each member's current position (from team_member/team_position) and setup completion status."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"list\": [\n        {\n            \"id\": 123,\n            \"name\": \"John Doe\",\n            \"email\": \"john@example.com\",\n            \"countryCallingCode\": 55,\n            \"cellphone\": \"11999999999\",\n            \"isUser\": 1,\n            \"isCollaborator\": 0,\n            \"language\": \"pt_BR\",\n            \"createdAt\": \"2026-01-15 10:30:00\",\n            \"position\": { \"id\": 5, \"name\": \"Regional Manager\" },\n            \"setupComplete\": true\n        }\n    ],\n    \"total\": 487,\n    \"counts\": {\n        \"all\": 487,\n        \"users\": 120,\n        \"nonUsers\": 367,\n        \"pendingSetup\": 45\n    },\n    \"pagination\": {\n        \"entries\": 20,\n        \"totalPages\": 25,\n        \"currentPage\": 1,\n        \"isInitial\": true,\n        \"isEnd\": false,\n        \"totalPrevPages\": 0,\n        \"totalNextPages\": 24\n    }\n}"
                        }
                    ]
                },
                {
                    "name": "Position",
                    "item": [
                        {
                            "name": "By Area (cargos da área)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{areaId}}/position",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area",
                                        "{{areaId}}",
                                        "position"
                                    ]
                                },
                                "description": "Lista flat de todos os cargos da área (não recursivo). Para a estrutura\nhierárquica completa, use o endpoint **Tree**."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{areaId}}/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "{{areaId}}",
                                                "position"
                                            ]
                                        },
                                        "description": "Lista flat de todos os cargos da área (não recursivo). Para a estrutura\nhierárquica completa, use o endpoint **Tree**."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    { \"id\": 10, \"areaId\": 2, \"parentId\": null, \"name\": \"Diretor de Marketing\", \"description\": null, \"data\": null },\n    { \"id\": 11, \"areaId\": 2, \"parentId\": 10,   \"name\": \"Gerente de Performance\", \"description\": null, \"data\": null },\n    { \"id\": 12, \"areaId\": 2, \"parentId\": 11,   \"name\": \"Analista de SEO\",        \"description\": null, \"data\": null }\n]"
                                }
                            ]
                        },
                        {
                            "name": "Create Position",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "position"
                                    ]
                                },
                                "description": "Cria um cargo dentro de uma área. Obrigatórios: `areaId`, `name`.\n\nSe `parentId` for informado, deve referenciar um cargo da **mesma** `areaId` —\no `CycleGuard` valida tanto a hierarquia quanto a integridade área↔cargo.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico\",\n    \"data\": null\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Cria um cargo dentro de uma área. Obrigatórios: `areaId`, `name`.\n\nSe `parentId` for informado, deve referenciar um cargo da **mesma** `areaId` —\no `CycleGuard` valida tanto a hierarquia quanto a integridade área↔cargo.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 12,\n    \"areaId\": 2,\n    \"parentId\": 11,\n    \"name\": \"Analista de SEO\",\n    \"description\": \"Responsável por SEO orgânico\",\n    \"data\": null\n}"
                                },
                                {
                                    "name": "Parent de outra área ou ciclo na cadeia",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Cria um cargo dentro de uma área. Obrigatórios: `areaId`, `name`.\n\nSe `parentId` for informado, deve referenciar um cargo da **mesma** `areaId` —\no `CycleGuard` valida tanto a hierarquia quanto a integridade área↔cargo.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"parentId must belong to the same areaId\",\n    \"code\": 422\n}"
                                }
                            ]
                        },
                        {
                            "name": "Delete Position",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "position"
                                    ]
                                },
                                "description": "Remove um cargo. Falha (FK RESTRICT) se houver vínculos (`team_member`)\napontando para ele — encerre os vínculos antes ou mova-os de cargo.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 12\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Remove um cargo. Falha (FK RESTRICT) se houver vínculos (`team_member`)\napontando para ele — encerre os vínculos antes ou mova-os de cargo.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 12\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Constraint — cargo referenciado por vínculos",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Remove um cargo. Falha (FK RESTRICT) se houver vínculos (`team_member`)\napontando para ele — encerre os vínculos antes ou mova-os de cargo.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 12\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 409,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"Cannot delete or update a parent row: a foreign key constraint fails\",\n    \"code\": 409\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get Position",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/position/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "position",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single the position matching the given identifier."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single the position matching the given identifier."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List Positions",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "position"
                                    ]
                                },
                                "description": "Returns a paginated list of positions."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Returns a paginated list of positions."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"list\": [\n        { \"id\": 10, \"areaId\": 2, \"parentId\": null, \"name\": \"Diretor de Marketing\" },\n        { \"id\": 11, \"areaId\": 2, \"parentId\": 10,   \"name\": \"Gerente de Performance\" },\n        { \"id\": 12, \"areaId\": 2, \"parentId\": 11,   \"name\": \"Analista de SEO\" }\n    ],\n    \"total\": 3, \"page\": 1, \"entries\": 50\n}"
                                }
                            ]
                        },
                        {
                            "name": "Tree (cadeia de cargos da área)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{areaId}}/position/tree",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "area",
                                        "{{areaId}}",
                                        "position",
                                        "tree"
                                    ]
                                },
                                "description": "Returns the tree of positions within an area — useful to render an area's organisational chart."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/area/{{areaId}}/position/tree",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "area",
                                                "{{areaId}}",
                                                "position",
                                                "tree"
                                            ]
                                        },
                                        "description": "Returns the tree of positions within an area — useful to render an area's organisational chart."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    {\n        \"id\": 10, \"areaId\": 2, \"parentId\": null, \"name\": \"Diretor de Marketing\", \"depth\": 0,\n        \"children\": [\n            { \"id\": 11, \"areaId\": 2, \"parentId\": 10, \"name\": \"Gerente de Performance\", \"depth\": 1, \"children\": [\n                { \"id\": 12, \"areaId\": 2, \"parentId\": 11, \"name\": \"Analista de SEO\", \"depth\": 2, \"children\": [] }\n            ] }\n        ]\n    }\n]"
                                }
                            ]
                        },
                        {
                            "name": "Update Position",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "position"
                                    ]
                                },
                                "description": "Atualiza um cargo. Envie apenas os campos que mudam — `id` é obrigatório.\n\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado.\nSe `areaId` não vier, o `areaId` atual do cargo é usado para validar o pai.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 12,\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO Sênior\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico e técnico\",\n    \"data\": null\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Atualiza um cargo. Envie apenas os campos que mudam — `id` é obrigatório.\n\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado.\nSe `areaId` não vier, o `areaId` atual do cargo é usado para validar o pai.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 12,\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO Sênior\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico e técnico\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Parent de outra área ou ciclo na cadeia",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/position",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "position"
                                            ]
                                        },
                                        "description": "Atualiza um cargo. Envie apenas os campos que mudam — `id` é obrigatório.\n\nSe `parentId` for incluído (mesmo como `null`), o `CycleGuard` é executado.\nSe `areaId` não vier, o `areaId` atual do cargo é usado para validar o pai.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 12,\n    \"areaId\": 2,\n    \"name\": \"Analista de SEO Sênior\",\n    \"parentId\": 11,\n    \"description\": \"Responsável por SEO orgânico e técnico\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"parentId must belong to the same areaId\",\n    \"code\": 422\n}"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Vínculos (Members)",
                    "item": [
                        {
                            "name": "By Area (ativos na área + sub-áreas)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/area/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member",
                                        "by",
                                        "area",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Retorna os vínculos **ativos** da área e de todas as suas sub-áreas\n(CTE recursiva). Cada item já vem com `positionName` e `areaId` para\no admin renderizar sem precisar de chamadas adicionais.\n\nPara listar apenas os cargos da área (sem pessoas), use\n`/api/register/team/area/{areaId}/position`."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/area/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "by",
                                                "area",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Retorna os vínculos **ativos** da área e de todas as suas sub-áreas\n(CTE recursiva). Cada item já vem com `positionName` e `areaId` para\no admin renderizar sem precisar de chamadas adicionais.\n\nPara listar apenas os cargos da área (sem pessoas), use\n`/api/register/team/area/{areaId}/position`."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    { \"id\": 7, \"personId\": 99, \"positionId\": 12, \"reportsTo\": 5,    \"startedAt\": \"2026-04-24\", \"endedAt\": null, \"data\": null, \"areaId\": 2, \"positionName\": \"Analista de SEO\" },\n    { \"id\": 5, \"personId\": 50, \"positionId\": 11, \"reportsTo\": null, \"startedAt\": \"2025-08-01\", \"endedAt\": null, \"data\": null, \"areaId\": 2, \"positionName\": \"Gerente de Performance\" }\n]"
                                }
                            ]
                        },
                        {
                            "name": "By Person (todos os vínculos da pessoa)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/person/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member",
                                        "by",
                                        "person",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Retorna o histórico completo de vínculos de uma pessoa — ativos\n(`endedAt IS NULL`) e encerrados — em ordem de cadastro."
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/person/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "by",
                                                "person",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Retorna o histórico completo de vínculos de uma pessoa — ativos\n(`endedAt IS NULL`) e encerrados — em ordem de cadastro."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    { \"id\": 4, \"personId\": 99, \"positionId\": 11, \"reportsTo\": null, \"startedAt\": \"2025-01-10\", \"endedAt\": \"2026-04-24\", \"data\": null },\n    { \"id\": 7, \"personId\": 99, \"positionId\": 12, \"reportsTo\": 5,    \"startedAt\": \"2026-04-24\", \"endedAt\": null,         \"data\": null }\n]"
                                }
                            ]
                        },
                        {
                            "name": "By Position (ativos no cargo)",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/position/{{positionId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member",
                                        "by",
                                        "position",
                                        "{{positionId}}"
                                    ]
                                },
                                "description": "Returns the members currently active in the given position."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/by/position/{{positionId}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "by",
                                                "position",
                                                "{{positionId}}"
                                            ]
                                        },
                                        "description": "Returns the members currently active in the given position."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Create / Activate",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member"
                                    ]
                                },
                                "description": "Cria um vínculo entre uma pessoa e um cargo. **Comportamento atômico (transação):**\n\n1. Se já existe vínculo ativo da `personId`, ele é encerrado (`endedAt = startedAt`).\n2. Cria o novo vínculo.\n3. Garante `person.isCollaborator = 1`.\n\nUse para contratar ou trocar de cargo. Para encerrar sem substituição, use `End`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"personId\": 99,\n    \"positionId\": 12,\n    \"reportsTo\": 5,\n    \"startedAt\": \"2026-04-24\",\n    \"data\": null\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member"
                                            ]
                                        },
                                        "description": "Cria um vínculo entre uma pessoa e um cargo. **Comportamento atômico (transação):**\n\n1. Se já existe vínculo ativo da `personId`, ele é encerrado (`endedAt = startedAt`).\n2. Cria o novo vínculo.\n3. Garante `person.isCollaborator = 1`.\n\nUse para contratar ou trocar de cargo. Para encerrar sem substituição, use `End`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 99,\n    \"positionId\": 12,\n    \"reportsTo\": 5,\n    \"startedAt\": \"2026-04-24\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 7,\n    \"personId\": 99,\n    \"positionId\": 12,\n    \"reportsTo\": 5,\n    \"startedAt\": \"2026-04-24\",\n    \"endedAt\": null,\n    \"data\": null\n}"
                                },
                                {
                                    "name": "personId / positionId / reportsTo inválido",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member"
                                            ]
                                        },
                                        "description": "Cria um vínculo entre uma pessoa e um cargo. **Comportamento atômico (transação):**\n\n1. Se já existe vínculo ativo da `personId`, ele é encerrado (`endedAt = startedAt`).\n2. Cria o novo vínculo.\n3. Garante `person.isCollaborator = 1`.\n\nUse para contratar ou trocar de cargo. Para encerrar sem substituição, use `End`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"personId\": 99,\n    \"positionId\": 12,\n    \"reportsTo\": 5,\n    \"startedAt\": \"2026-04-24\",\n    \"data\": null\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"personId not found in this organization\",\n    \"code\": 422\n}"
                                }
                            ]
                        },
                        {
                            "name": "Delete (sem histórico)",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member"
                                    ]
                                },
                                "description": "Apaga o registro de vínculo **definitivamente**. Use só para corrigir erros\nde cadastro. Para encerrar mantendo histórico (ex: demissão), use **End**.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 7\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member"
                                            ]
                                        },
                                        "description": "Apaga o registro de vínculo **definitivamente**. Use só para corrigir erros\nde cadastro. Para encerrar mantendo histórico (ex: demissão), use **End**.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 7\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        },
                        {
                            "name": "End (encerrar mantendo histórico)",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}/end",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member",
                                        "{{id}}",
                                        "end"
                                    ]
                                },
                                "description": "Encerra o vínculo (saída/demissão) preenchendo `endedAt`. Diferente do DELETE,\no registro é mantido para auditoria/histórico.\n\nBody é opcional — se omitir `endedAt`, usa hoje. `endedAt` não pode ser anterior\na `startedAt`.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"endedAt\": \"2026-04-24\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Successful Response",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}/end",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "{{id}}",
                                                "end"
                                            ]
                                        },
                                        "description": "Encerra o vínculo (saída/demissão) preenchendo `endedAt`. Diferente do DELETE,\no registro é mantido para auditoria/histórico.\n\nBody é opcional — se omitir `endedAt`, usa hoje. `endedAt` não pode ser anterior\na `startedAt`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"endedAt\": \"2026-04-24\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\": 7,\n    \"personId\": 99,\n    \"positionId\": 12,\n    \"reportsTo\": 5,\n    \"startedAt\": \"2026-04-24\",\n    \"endedAt\": \"2026-04-24\",\n    \"data\": null\n}"
                                },
                                {
                                    "name": "Vínculo não encontrado nesta organização",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}/end",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "{{id}}",
                                                "end"
                                            ]
                                        },
                                        "description": "Encerra o vínculo (saída/demissão) preenchendo `endedAt`. Diferente do DELETE,\no registro é mantido para auditoria/histórico.\n\nBody é opcional — se omitir `endedAt`, usa hoje. `endedAt` não pode ser anterior\na `startedAt`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"endedAt\": \"2026-04-24\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"member not found in this organization\",\n    \"code\": 404\n}"
                                },
                                {
                                    "name": "Já encerrado ou data inválida",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}/end",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "{{id}}",
                                                "end"
                                            ]
                                        },
                                        "description": "Encerra o vínculo (saída/demissão) preenchendo `endedAt`. Diferente do DELETE,\no registro é mantido para auditoria/histórico.\n\nBody é opcional — se omitir `endedAt`, usa hoje. `endedAt` não pode ser anterior\na `startedAt`.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"endedAt\": \"2026-04-24\"\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Unprocessable Entity",
                                    "code": 422,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"message\": \"member is already ended\",\n    \"code\": 422\n}"
                                }
                            ]
                        },
                        {
                            "name": "Get Team Member",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single the member matching the given identifier."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single the member matching the given identifier."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "List Team Members",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member"
                                    ]
                                },
                                "description": "Returns a paginated list of members."
                            },
                            "response": [
                                {
                                    "name": "Success",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member"
                                            ]
                                        },
                                        "description": "Returns a paginated list of members."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": ""
                                }
                            ]
                        },
                        {
                            "name": "Update Team Member",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "team",
                                        "member"
                                    ]
                                },
                                "description": "Atualiza campos de um vínculo existente. Use **apenas** para corrigir\n`reportsTo`, `data`, `startedAt`. Para trocar de cargo, use **Create / Activate**\n(que encerra o vínculo anterior automaticamente).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"id\": 7,\n    \"reportsTo\": 6,\n    \"startedAt\": \"2026-04-24\",\n    \"data\": {\n        \"note\": \"transferido para gerente novo\"\n    }\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/team/member",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "team",
                                                "member"
                                            ]
                                        },
                                        "description": "Atualiza campos de um vínculo existente. Use **apenas** para corrigir\n`reportsTo`, `data`, `startedAt`. Para trocar de cargo, use **Create / Activate**\n(que encerra o vínculo anterior automaticamente).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"id\": 7,\n    \"reportsTo\": 6,\n    \"startedAt\": \"2026-04-24\",\n    \"data\": {\n        \"note\": \"transferido para gerente novo\"\n    }\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                }
                            ]
                        }
                    ]
                }
            ]
        },
        {
            "name": "Tier",
            "item": [
                {
                    "name": "Balance",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "{{personId}}",
                                "tier"
                            ]
                        },
                        "description": "Returns the current tier balance for a person — active points, current level id, next level name and how many points are missing to reach it.\nThe current level **name** is not in the payload; resolve it from the tier configuration using `levelId` (see [Tier config — Read](../config/read))."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier"
                                    ]
                                },
                                "description": "Returns the current tier balance for a person — active points, current level id, next level name and how many points are missing to reach it.\nThe current level **name** is not in the payload; resolve it from the tier configuration using `levelId` (see [Tier config — Read](../config/read))."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"person\":       44,\n    \"activePoints\": 2350,\n    \"levelId\":      2,\n    \"nextLevel\":    \"Gold\",\n    \"pointsToNext\": 2650\n}"
                        },
                        {
                            "name": "No tier yet",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier"
                                    ]
                                },
                                "description": "Returns the current tier balance for a person — active points, current level id, next level name and how many points are missing to reach it.\nThe current level **name** is not in the payload; resolve it from the tier configuration using `levelId` (see [Tier config — Read](../config/read))."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"person\": 44, \"activePoints\": 0 }"
                        }
                    ]
                },
                {
                    "name": "Tier config",
                    "item": [
                        {
                            "name": "Create Config",
                            "request": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tier/config",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tier",
                                        "config"
                                    ]
                                },
                                "description": "Creates a new tier configuration. Each organization can run more than one program in parallel (e.g. customer tier + collaborator tier).",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Programa Guper\",\n    \"levels\": [\n        {\n            \"name\": \"Silver\",\n            \"minPoints\": 1000\n        }\n    ],\n    \"sources\": \"{\\\"rewardCampaign\\\": {\\\"multiplier\\\": 1, \\\"expiresInDays\\\": 365, \\\"campaigns\\\": [12, 40]}}\",\n    \"isActive\": true,\n    \"autoEnrollOnOptIn\": true\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Created",
                                    "originalRequest": {
                                        "method": "POST",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config"
                                            ]
                                        },
                                        "description": "Creates a new tier configuration. Each organization can run more than one program in parallel (e.g. customer tier + collaborator tier).",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Programa Guper\",\n    \"levels\": [\n        {\n            \"name\": \"Silver\",\n            \"minPoints\": 1000\n        }\n    ],\n    \"sources\": \"{\\\"rewardCampaign\\\": {\\\"multiplier\\\": 1, \\\"expiresInDays\\\": 365, \\\"campaigns\\\": [12, 40]}}\",\n    \"isActive\": true,\n    \"autoEnrollOnOptIn\": true\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\":        2,\n    \"name\":      \"Colaboradores Guper\",\n    \"isActive\":  true,\n    \"createdAt\": \"2026-05-01T12:34:56-03:00\"\n}"
                                }
                            ]
                        },
                        {
                            "name": "Delete Config",
                            "request": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tier",
                                        "config",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Removes a tier configuration. Existing person tier ledgers tied to it are kept; only the configuration is dropped."
                            },
                            "response": [
                                {
                                    "name": "Removed",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Removes a tier configuration. Existing person tier ledgers tied to it are kept; only the configuration is dropped."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Missing path parameter",
                                    "originalRequest": {
                                        "method": "DELETE",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Removes a tier configuration. Existing person tier ledgers tied to it are kept; only the configuration is dropped."
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"error\": \"bad_request\", \"message\": \"The 'id' path parameter is required\" }"
                                }
                            ]
                        },
                        {
                            "name": "List Tier Configs — loyalty levels (tiers), point ranges & benefits",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tier/config",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tier",
                                        "config"
                                    ]
                                },
                                "description": "Returns every tier program configuration belonging to the organization."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config"
                                            ]
                                        },
                                        "description": "Returns every tier program configuration belonging to the organization."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "[\n    {\n        \"id\":         1,\n        \"name\":       \"Programa Guper\",\n        \"levels\": [\n            { \"id\": 1, \"name\": \"Bronze\",   \"minPoints\": 0     },\n            { \"id\": 2, \"name\": \"Silver\",   \"minPoints\": 1000  },\n            { \"id\": 3, \"name\": \"Gold\",     \"minPoints\": 5000  },\n            { \"id\": 4, \"name\": \"Platinum\", \"minPoints\": 15000 }\n        ],\n        \"sources\": [\n            { \"source\": \"rewardCampaign\", \"expiresInDays\": 365 },\n            { \"source\": \"manual\",         \"expiresInDays\": null }\n        ],\n        \"isActive\":          true,\n        \"autoEnrollOnOptIn\": false,\n        \"createdAt\":         \"2026-01-15T09:00:00-03:00\",\n        \"updatedAt\":         \"2026-04-20T11:30:00-03:00\"\n    }\n]"
                                }
                            ]
                        },
                        {
                            "name": "Get Config",
                            "request": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tier",
                                        "config",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Returns a single tier configuration by ID."
                            },
                            "response": [
                                {
                                    "name": "OK",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single tier configuration by ID."
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{\n    \"id\":       1,\n    \"name\":     \"Programa Guper\",\n    \"levels\": [\n        { \"id\": 1, \"name\": \"Bronze\",   \"minPoints\": 0    },\n        { \"id\": 2, \"name\": \"Silver\",   \"minPoints\": 1000 },\n        { \"id\": 3, \"name\": \"Gold\",     \"minPoints\": 5000 }\n    ],\n    \"sources\": [\n        { \"source\": \"rewardCampaign\", \"expiresInDays\": 365 }\n    ],\n    \"isActive\": true\n}"
                                },
                                {
                                    "name": "Not found",
                                    "originalRequest": {
                                        "method": "GET",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Returns a single tier configuration by ID."
                                    },
                                    "status": "Not Found",
                                    "code": 404,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"error\": \"not_found\", \"message\": \"Tier config not found\" }"
                                }
                            ]
                        },
                        {
                            "name": "Update Config",
                            "request": {
                                "method": "PUT",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "tier",
                                        "config",
                                        "{{id}}"
                                    ]
                                },
                                "description": "Updates an existing tier configuration. Only fields included in the body are changed; level/source arrays are replaced wholesale.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"name\": \"Programa Guper 2026\",\n    \"levels\": \"<levels>\",\n    \"sources\": \"<sources>\",\n    \"isActive\": false,\n    \"autoEnrollOnOptIn\": true\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "response": [
                                {
                                    "name": "Updated",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Updates an existing tier configuration. Only fields included in the body are changed; level/source arrays are replaced wholesale.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Programa Guper 2026\",\n    \"levels\": \"<levels>\",\n    \"sources\": \"<sources>\",\n    \"isActive\": false,\n    \"autoEnrollOnOptIn\": true\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "OK",
                                    "code": 200,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"affectedRows\": 1 }"
                                },
                                {
                                    "name": "Missing path parameter",
                                    "originalRequest": {
                                        "method": "PUT",
                                        "header": [
                                            {
                                                "key": "x-guper-authorization",
                                                "value": "{{x-guper-authorization}}",
                                                "type": "text",
                                                "description": "User token issued by Guper."
                                            },
                                            {
                                                "key": "Content-Type",
                                                "value": "{{Content-Type}}",
                                                "type": "text",
                                                "description": "Always `application/json` for endpoints that accept a JSON body."
                                            }
                                        ],
                                        "url": {
                                            "raw": "https://{{organization}}.myguper.com/api/register/tier/config/{{id}}",
                                            "protocol": "https",
                                            "host": [
                                                "{{organization}}",
                                                "myguper",
                                                "com"
                                            ],
                                            "path": [
                                                "api",
                                                "register",
                                                "tier",
                                                "config",
                                                "{{id}}"
                                            ]
                                        },
                                        "description": "Updates an existing tier configuration. Only fields included in the body are changed; level/source arrays are replaced wholesale.",
                                        "body": {
                                            "mode": "raw",
                                            "raw": "{\n    \"name\": \"Programa Guper 2026\",\n    \"levels\": \"<levels>\",\n    \"sources\": \"<sources>\",\n    \"isActive\": false,\n    \"autoEnrollOnOptIn\": true\n}",
                                            "options": {
                                                "raw": {
                                                    "language": "json"
                                                }
                                            }
                                        }
                                    },
                                    "status": "Bad Request",
                                    "code": 400,
                                    "_postman_previewlanguage": "json",
                                    "header": [
                                        {
                                            "key": "Content-Type",
                                            "value": "application/json"
                                        }
                                    ],
                                    "body": "{ \"error\": \"bad_request\", \"message\": \"The 'id' path parameter is required\" }"
                                }
                            ]
                        }
                    ]
                },
                {
                    "name": "Flow",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/flow",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "{{personId}}",
                                "tier",
                                "flow"
                            ]
                        },
                        "description": "Returns the full tier-points ledger for a person — every credit/debit with its source, expiration and description. Use to render a \"tier history\" view."
                    },
                    "response": [
                        {
                            "name": "OK",
                            "originalRequest": {
                                "method": "GET",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/flow",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier",
                                        "flow"
                                    ]
                                },
                                "description": "Returns the full tier-points ledger for a person — every credit/debit with its source, expiration and description. Use to render a \"tier history\" view."
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "[\n    {\n        \"id\":          501,\n        \"person\":      44,\n        \"tierConfig\":  1,\n        \"source\":      \"rewardCampaign\",\n        \"sourceId\":    \"tx_demo_a1b2c3d4\",\n        \"operation\":   \"credit\",\n        \"points\":      150,\n        \"expireAt\":    \"2027-05-01T00:00:00-03:00\",\n        \"description\": \"Cashback ord_2026_001\",\n        \"createdAt\":   \"2026-05-01T12:34:56-03:00\"\n    },\n    {\n        \"id\":          502,\n        \"person\":      44,\n        \"tierConfig\":  1,\n        \"source\":      \"manual\",\n        \"sourceId\":    \"ops-44-bonus\",\n        \"operation\":   \"credit\",\n        \"points\":      500,\n        \"expireAt\":    null,\n        \"description\": \"Welcome bonus\",\n        \"createdAt\":   \"2026-05-02T09:00:00-03:00\"\n    }\n]"
                        }
                    ]
                },
                {
                    "name": "Add points",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "{{personId}}",
                                "tier",
                                "points"
                            ]
                        },
                        "description": "Adds a tier-points entry to a person. Tier balance and level are recalculated\nimmediately. Use `source: rewardCampaign` (with the `sourceId` of the underlying\ntransaction) when the points come from a loyalty event, or `source: manual`\nfor ops-driven adjustments.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"source\": \"rewardCampaign\",\n    \"sourceId\": \"tx_demo_a1b2c3d4\",\n    \"value\": 150,\n    \"expireAt\": \"2027-05-01T00:00:00-03:00\",\n    \"description\": \"Cashback ord_2026_001\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Points credited",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier",
                                        "points"
                                    ]
                                },
                                "description": "Adds a tier-points entry to a person. Tier balance and level are recalculated\nimmediately. Use `source: rewardCampaign` (with the `sourceId` of the underlying\ntransaction) when the points come from a loyalty event, or `source: manual`\nfor ops-driven adjustments.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"source\": \"rewardCampaign\",\n    \"sourceId\": \"tx_demo_a1b2c3d4\",\n    \"value\": 150,\n    \"expireAt\": \"2027-05-01T00:00:00-03:00\",\n    \"description\": \"Cashback ord_2026_001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\":      true,\n    \"pointsAdded\":  150,\n    \"source\":       \"rewardCampaign\",\n    \"activePoints\": 2350\n}"
                        },
                        {
                            "name": "Missing required field",
                            "originalRequest": {
                                "method": "POST",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier",
                                        "points"
                                    ]
                                },
                                "description": "Adds a tier-points entry to a person. Tier balance and level are recalculated\nimmediately. Use `source: rewardCampaign` (with the `sourceId` of the underlying\ntransaction) when the points come from a loyalty event, or `source: manual`\nfor ops-driven adjustments.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"source\": \"rewardCampaign\",\n    \"sourceId\": \"tx_demo_a1b2c3d4\",\n    \"value\": 150,\n    \"expireAt\": \"2027-05-01T00:00:00-03:00\",\n    \"description\": \"Cashback ord_2026_001\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Bad Request",
                            "code": 400,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"bad_request\", \"message\": \"Missing required field: source\" }"
                        }
                    ]
                },
                {
                    "name": "Remove points",
                    "request": {
                        "method": "DELETE",
                        "header": [
                            {
                                "key": "x-guper-authorization",
                                "value": "{{x-guper-authorization}}",
                                "type": "text",
                                "description": "User token issued by Guper."
                            },
                            {
                                "key": "Content-Type",
                                "value": "{{Content-Type}}",
                                "type": "text",
                                "description": "Always `application/json` for endpoints that accept a JSON body."
                            }
                        ],
                        "url": {
                            "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points/{{sourceId}}",
                            "protocol": "https",
                            "host": [
                                "{{organization}}",
                                "myguper",
                                "com"
                            ],
                            "path": [
                                "api",
                                "register",
                                "person",
                                "{{personId}}",
                                "tier",
                                "points",
                                "{{sourceId}}"
                            ]
                        },
                        "description": "Reverses a tier-points entry. Use this to undo points credited earlier — for\nexample when the underlying loyalty transaction was cancelled. The reversal\nkeeps an audit row in Flow (`operation: debit`) so the history stays auditable.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"source\": \"rewardCampaign\"\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": [
                        {
                            "name": "Points removed",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points/{{sourceId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier",
                                        "points",
                                        "{{sourceId}}"
                                    ]
                                },
                                "description": "Reverses a tier-points entry. Use this to undo points credited earlier — for\nexample when the underlying loyalty transaction was cancelled. The reversal\nkeeps an audit row in Flow (`operation: debit`) so the history stays auditable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"source\": \"rewardCampaign\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "OK",
                            "code": 200,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{\n    \"success\":        true,\n    \"pointsCanceled\": 150,\n    \"activePoints\":   2200\n}"
                        },
                        {
                            "name": "Source entry not found",
                            "originalRequest": {
                                "method": "DELETE",
                                "header": [
                                    {
                                        "key": "x-guper-authorization",
                                        "value": "{{x-guper-authorization}}",
                                        "type": "text",
                                        "description": "User token issued by Guper."
                                    },
                                    {
                                        "key": "Content-Type",
                                        "value": "{{Content-Type}}",
                                        "type": "text",
                                        "description": "Always `application/json` for endpoints that accept a JSON body."
                                    }
                                ],
                                "url": {
                                    "raw": "https://{{organization}}.myguper.com/api/register/person/{{personId}}/tier/points/{{sourceId}}",
                                    "protocol": "https",
                                    "host": [
                                        "{{organization}}",
                                        "myguper",
                                        "com"
                                    ],
                                    "path": [
                                        "api",
                                        "register",
                                        "person",
                                        "{{personId}}",
                                        "tier",
                                        "points",
                                        "{{sourceId}}"
                                    ]
                                },
                                "description": "Reverses a tier-points entry. Use this to undo points credited earlier — for\nexample when the underlying loyalty transaction was cancelled. The reversal\nkeeps an audit row in Flow (`operation: debit`) so the history stays auditable.",
                                "body": {
                                    "mode": "raw",
                                    "raw": "{\n    \"source\": \"rewardCampaign\"\n}",
                                    "options": {
                                        "raw": {
                                            "language": "json"
                                        }
                                    }
                                }
                            },
                            "status": "Not Found",
                            "code": 404,
                            "_postman_previewlanguage": "json",
                            "header": [
                                {
                                    "key": "Content-Type",
                                    "value": "application/json"
                                }
                            ],
                            "body": "{ \"error\": \"not_found\", \"message\": \"No tier-points entry matches the given personId + sourceId\" }"
                        }
                    ]
                }
            ]
        }
    ],
    "variable": [
        {
            "key": "scheme",
            "value": "https",
            "type": "string"
        },
        {
            "key": "organization",
            "value": "acme",
            "type": "string"
        },
        {
            "key": "TID",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "confirmToken",
            "value": "54eb6281f4e3e13671a5e4c95609f4a69247a5f38d01bef99768399bb6645c49",
            "type": "string"
        },
        {
            "key": "hash",
            "value": "h_demo_abc123def456",
            "type": "string"
        },
        {
            "key": "id",
            "value": "42",
            "type": "string"
        },
        {
            "key": "personId",
            "value": "1234",
            "type": "string"
        },
        {
            "key": "couponCode",
            "value": "DEMO20",
            "type": "string"
        },
        {
            "key": "transactionId",
            "value": "tx_demo_a1b2c3d4",
            "type": "string"
        },
        {
            "key": "dateStart",
            "value": "2024-04-01",
            "type": "string"
        },
        {
            "key": "dateEnd",
            "value": "2024-04-30",
            "type": "string"
        },
        {
            "key": "x-guper-authorization",
            "value": "48c70a3d6bc1d15104abfaee80c6010f348713f5315bfd12028c2455667685a2",
            "type": "string"
        },
        {
            "key": "Content-Type",
            "value": "application/json",
            "type": "string"
        },
        {
            "key": "User-Agent",
            "value": "guper-docs/2.x",
            "type": "string"
        },
        {
            "key": "environment",
            "value": "",
            "type": "string"
        }
    ]
}