API ReferenceEndpointsPublic API (v1)Set this region as the store default

Set this region as the store default

Makes this region the store default and clears the flag on the previous default. An inactive region cannot be the default.

PATCH
/v1/regions/{regionId}/set-default
AuthorizationBearer <token>

Admin API key (server-to-server). Issue via the dashboard at Settings → API keys. Plain-text key is shown once — store in a secret manager. Format: Authorization: Bearer brainerce_xxxxxxxxx.

In: header

Path Parameters

regionIdstring

Region ID

curl -X PATCH "https://api.brainerce.com/api/v1/regions/string/set-default"
{
  "id": "clx1a2b3c4d5e6f7g8h9",
  "accountId": "clx1a2b3c4d5e6f7g8h9",
  "storeId": "clx1a2b3c4d5e6f7g8h9",
  "name": "Israel",
  "slug": "israel",
  "currency": "USD",
  "fxBufferPercent": "2.00",
  "countries": [
    "string"
  ],
  "provinces": {},
  "taxInclusive": true,
  "effectiveTaxInclusive": true,
  "automaticTaxes": true,
  "isDefault": true,
  "isActive": true,
  "metadata": {},
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "paymentProviders": [
    {
      "id": "clx1a2b3c4d5e6f7g8h9",
      "regionId": "clx1a2b3c4d5e6f7g8h9",
      "appInstallationId": "clx1a2b3c4d5e6f7g8h9",
      "isEnabled": true,
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ]
}

{
  "statusCode": 400,
  "code": "VALIDATION_FAILED",
  "message": "name should not be empty, price must be a positive number",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/regions/{regionId}/set-default"
}

{
  "statusCode": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid or expired credential",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/products/bulk/{jobId}"
}

{
  "statusCode": 403,
  "code": "INSUFFICIENT_SCOPE",
  "message": "API key does not have the required scope: products:write",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/regions/{regionId}/set-default"
}

{
  "statusCode": 404,
  "code": "RESOURCE_NOT_FOUND",
  "message": "Resource not found",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/regions/{regionId}/set-default"
}

{
  "statusCode": 429,
  "code": "RATE_LIMITED",
  "message": "Too many requests",
  "details": {
    "retryAfterSeconds": 12
  },
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/v1/store"
}