brilliant-directories-mcp 3.0.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/openapi/bd-api.json +93 -77
  2. package/package.json +1 -1
@@ -3113,7 +3113,7 @@
3113
3113
  },
3114
3114
  "/api/v2/data_posts/get": {
3115
3115
  "get": {
3116
- "operationId": "listPosts",
3116
+ "operationId": "listSingleImagePosts",
3117
3117
  "summary": "List posts",
3118
3118
  "tags": [
3119
3119
  "Posts"
@@ -3144,12 +3144,12 @@
3144
3144
  }
3145
3145
  }
3146
3146
  },
3147
- "description": "Paginated enumeration of post records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getPost` (single record by ID), `searchPosts` (keyword search).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3147
+ "description": "Paginated enumeration of post records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getSingleImagePost` (single record by ID), `searchSingleImagePosts` (keyword search).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3148
3148
  }
3149
3149
  },
3150
3150
  "/api/v2/data_posts/get/{post_id}": {
3151
3151
  "get": {
3152
- "operationId": "getPost",
3152
+ "operationId": "getSingleImagePost",
3153
3153
  "summary": "Get a single post",
3154
3154
  "tags": [
3155
3155
  "Posts"
@@ -3176,12 +3176,12 @@
3176
3176
  }
3177
3177
  }
3178
3178
  },
3179
- "description": "Fetch a single post record. Read-only.\n\n**Required:** `post_id`.\n\n**See also:** `listPosts` (enumerate many), `searchPosts` (keyword search).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3179
+ "description": "Fetch a single post record. Read-only.\n\n**Required:** `post_id`.\n\n**See also:** `listSingleImagePosts` (enumerate many), `searchSingleImagePosts` (keyword search).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3180
3180
  }
3181
3181
  },
3182
3182
  "/api/v2/data_posts/fields": {
3183
3183
  "get": {
3184
- "operationId": "getPostFields",
3184
+ "operationId": "getSingleImagePostFields",
3185
3185
  "summary": "Get post field definitions",
3186
3186
  "description": "Returns custom fields for a specific post type form.\n\n**Required:** `form_name`.\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
3187
3187
  "tags": [
@@ -3214,7 +3214,7 @@
3214
3214
  },
3215
3215
  "/api/v2/data_posts/create": {
3216
3216
  "post": {
3217
- "operationId": "createPost",
3217
+ "operationId": "createSingleImagePost",
3218
3218
  "summary": "Create a post",
3219
3219
  "tags": [
3220
3220
  "Posts"
@@ -3262,6 +3262,14 @@
3262
3262
  },
3263
3263
  "post_price": {
3264
3264
  "type": "number"
3265
+ },
3266
+ "auto_image_import": {
3267
+ "type": "integer",
3268
+ "enum": [
3269
+ 0,
3270
+ 1
3271
+ ],
3272
+ "description": "**Auto-import images to site storage.** When any external image URL field is supplied on this single-image post (e.g. a feature image URL from a web-scrape), set `auto_image_import=1` to have BD fetch the image and save it locally. Without this flag, BD stores the URL as-is — images break if the source host goes down. **Recommended default when supplying external image URLs;** omit (or set `0`) only when the user explicitly wants to keep the external URL reference. Processing delay: a few minutes."
3265
3273
  }
3266
3274
  }
3267
3275
  }
@@ -3280,12 +3288,12 @@
3280
3288
  }
3281
3289
  }
3282
3290
  },
3283
- "description": "Create a new post record. Writes live data.\n\n**Required:** `user_id`, `data_id`, `data_type`.\n\n**Parameter interactions:**\n- `user_id` — owner; must be an existing member (discover via `listUsers` or `searchUsers`)\n- `data_id` — post type category ID; get via `listPostTypes`\n- `data_type` — data type classification; usually matches the post type's data type\n- `post_status`: `0`=Draft (not visible), `1`=Published (public)\n- Response includes both `post_id` and `post_token` — the token is used for sharable URLs\n\n**See also:** `updatePost` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3291
+ "description": "Create a new post record. Writes live data.\n\n**Required:** `user_id`, `data_id`, `data_type`.\n\n**Parameter interactions:**\n- `user_id` — owner; must be an existing member (discover via `listUsers` or `searchUsers`)\n- `data_id` — post type category ID; get via `listPostTypes`\n- `data_type` — data type classification; usually matches the post type's data type\n- `post_status`: `0`=Draft (not visible), `1`=Published (public)\n- Response includes both `post_id` and `post_token` — the token is used for sharable URLs\n\n**See also:** `updateSingleImagePost` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n---\n\n**Which endpoint to use — `data_type` family decides:**\n\nEvery post type in `data_categories` has a `data_type` field that classifies its family. Call `listPostTypes` or `getPostType` to see the `data_type` of your target post type, then choose:\n\n| `data_type` value | Family | Use endpoint |\n|---|---|---|\n| `4` | Multi-image (albums, galleries, photo-heavy listings — e.g. Classified, Photo Album, Property, Product) | `createMultiImagePost` |\n| `9` | Single-image video | `createSingleImagePost` |\n| `20` | Single-image article / event / blog / job / coupon | `createSingleImagePost` |\n| `10`, `13`, `21`, `29` (and similar) | Internal admin types (Member Listings, Reviews, Specialties, Favorites) — NOT posts | Use the resource-specific endpoint (e.g. `createReview` for `data_type=13`) |\n\nIf you call the wrong create endpoint for a given post type, BD may accept the row but it won't render on the public site correctly.\n\n**For \"make a blog post\" intent:** look up `data_categories` for `data_name` matching \"blog\" (commonly `data_id=14` with `data_type=20`) → `createSingleImagePost` with that `data_id` + `data_type`.\n\n**For \"make a photo album\" / \"gallery\" intent:** look up the album post type (often `data_id=10`, `data_type=4`) → `createMultiImagePost` with that `data_id` + `data_type`. Photos are added separately via `createMultiImagePostPhoto` using the returned `group_id`.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3284
3292
  }
3285
3293
  },
3286
3294
  "/api/v2/data_posts/update": {
3287
3295
  "put": {
3288
- "operationId": "updatePost",
3296
+ "operationId": "updateSingleImagePost",
3289
3297
  "summary": "Update a post",
3290
3298
  "tags": [
3291
3299
  "Posts"
@@ -3334,12 +3342,12 @@
3334
3342
  }
3335
3343
  }
3336
3344
  },
3337
- "description": "Update an existing post record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `post_id`.\n\n**Enums:** `post_status`: `0`=Draft (saved but not publicly visible), `1`=Published (publicly visible on the site).\n\n**See also:** `createPost` (add new), `deletePost` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3345
+ "description": "Update an existing post record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `post_id`.\n\n**Enums:** `post_status`: `0`=Draft (saved but not publicly visible), `1`=Published (publicly visible on the site).\n\n**See also:** `createSingleImagePost` (add new), `deleteSingleImagePost` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3338
3346
  }
3339
3347
  },
3340
3348
  "/api/v2/data_posts/delete": {
3341
3349
  "delete": {
3342
- "operationId": "deletePost",
3350
+ "operationId": "deleteSingleImagePost",
3343
3351
  "summary": "Delete a post",
3344
3352
  "tags": [
3345
3353
  "Posts"
@@ -3374,12 +3382,12 @@
3374
3382
  }
3375
3383
  }
3376
3384
  },
3377
- "description": "Permanently delete a post record by ID. Destructive — cannot be undone via API.\n\n**Required:** `post_id`.\n\n**See also:** `updatePost` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3385
+ "description": "Permanently delete a post record by ID. Destructive — cannot be undone via API.\n\n**Required:** `post_id`.\n\n**See also:** `updateSingleImagePost` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3378
3386
  }
3379
3387
  },
3380
3388
  "/api/v2/data_posts/search": {
3381
3389
  "post": {
3382
- "operationId": "searchPosts",
3390
+ "operationId": "searchSingleImagePosts",
3383
3391
  "summary": "Search posts",
3384
3392
  "tags": [
3385
3393
  "Posts"
@@ -3426,12 +3434,12 @@
3426
3434
  }
3427
3435
  }
3428
3436
  },
3429
- "description": "Keyword search across post records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` to paginate large result sets.\n\n**Parameter interactions:**\n- `data_id` (post type) is strongly recommended — results vary significantly by post type configuration\n- `q` — keyword across post title, caption, content\n- Fields exposed in search depend on the post type; use `getPostFields` with `form_name` to discover them\n\n**See also:** `getPost` (single record by ID), `listPosts` (full enumeration).\n\n**Returns:** `{ status: \"success\", message: [...records] }`. Supports pagination fields when result set is large.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3437
+ "description": "Keyword search across post records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` to paginate large result sets.\n\n**Parameter interactions:**\n- `data_id` (post type) is strongly recommended — results vary significantly by post type configuration\n- `q` — keyword across post title, caption, content\n- Fields exposed in search depend on the post type; use `getSingleImagePostFields` with `form_name` to discover them\n\n**See also:** `getSingleImagePost` (single record by ID), `listSingleImagePosts` (full enumeration).\n\n**Returns:** `{ status: \"success\", message: [...records] }`. Supports pagination fields when result set is large.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3430
3438
  }
3431
3439
  },
3432
3440
  "/api/v2/users_portfolio_groups/get": {
3433
3441
  "get": {
3434
- "operationId": "listPortfolioGroups",
3442
+ "operationId": "listMultiImagePosts",
3435
3443
  "summary": "List album groups",
3436
3444
  "tags": [
3437
3445
  "Portfolio Groups"
@@ -3462,12 +3470,12 @@
3462
3470
  }
3463
3471
  }
3464
3472
  },
3465
- "description": "Paginated enumeration of portfoliogroup records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getPortfolioGroup` (single record by ID), `searchPortfolioGroups` (keyword search).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3473
+ "description": "Paginated enumeration of portfoliogroup records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getMultiImagePost` (single record by ID), `searchMultiImagePosts` (keyword search).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3466
3474
  }
3467
3475
  },
3468
3476
  "/api/v2/users_portfolio_groups/get/{group_id}": {
3469
3477
  "get": {
3470
- "operationId": "getPortfolioGroup",
3478
+ "operationId": "getMultiImagePost",
3471
3479
  "summary": "Get a single album group",
3472
3480
  "tags": [
3473
3481
  "Portfolio Groups"
@@ -3494,12 +3502,12 @@
3494
3502
  }
3495
3503
  }
3496
3504
  },
3497
- "description": "Fetch a single portfoliogroup record. Read-only.\n\n**Required:** `group_id`.\n\n**See also:** `listPortfolioGroups` (enumerate many), `searchPortfolioGroups` (keyword search).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3505
+ "description": "Fetch a single portfoliogroup record. Read-only.\n\n**Required:** `group_id`.\n\n**See also:** `listMultiImagePosts` (enumerate many), `searchMultiImagePosts` (keyword search).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3498
3506
  }
3499
3507
  },
3500
3508
  "/api/v2/users_portfolio_groups/fields": {
3501
3509
  "get": {
3502
- "operationId": "getPortfolioGroupFields",
3510
+ "operationId": "getMultiImagePostFields",
3503
3511
  "summary": "Get album group field definitions",
3504
3512
  "tags": [
3505
3513
  "Portfolio Groups"
@@ -3531,7 +3539,7 @@
3531
3539
  },
3532
3540
  "/api/v2/users_portfolio_groups/create": {
3533
3541
  "post": {
3534
- "operationId": "createPortfolioGroup",
3542
+ "operationId": "createMultiImagePost",
3535
3543
  "summary": "Create an album group",
3536
3544
  "tags": [
3537
3545
  "Portfolio Groups"
@@ -3570,6 +3578,14 @@
3570
3578
  0,
3571
3579
  1
3572
3580
  ]
3581
+ },
3582
+ "auto_image_import": {
3583
+ "type": "integer",
3584
+ "enum": [
3585
+ 0,
3586
+ 1
3587
+ ],
3588
+ "description": "**Auto-import images to site storage.** When any external image URL field is supplied on this multi-image post (e.g. a feature image URL from a web-scrape), set `auto_image_import=1` to have BD fetch the image and save it locally. Without this flag, BD stores the URL as-is — images break if the source host goes down. **Recommended default when supplying external image URLs;** omit (or set `0`) only when the user explicitly wants to keep the external URL reference. Processing delay: a few minutes."
3573
3589
  }
3574
3590
  }
3575
3591
  }
@@ -3588,12 +3604,12 @@
3588
3604
  }
3589
3605
  }
3590
3606
  },
3591
- "description": "Create a new portfoliogroup record. Writes live data.\n\n**Required:** `user_id`, `data_id`, `data_type`.\n\n**Parameter interactions:**\n- `data_id` + `data_type` — specify the post type this album belongs to (from `listPostTypes` / `listDataTypes`)\n- `group_status`: `0`=Hidden, `1`=Published\n- Photos are added separately via `createPortfolioPhoto` using the returned `group_id`\n\n**See also:** `updatePortfolioGroup` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3607
+ "description": "Create a new portfoliogroup record. Writes live data.\n\n**Required:** `user_id`, `data_id`, `data_type`.\n\n**Parameter interactions:**\n- `data_id` + `data_type` — specify the post type this album belongs to (from `listPostTypes` / `listDataTypes`)\n- `group_status`: `0`=Hidden, `1`=Published\n- Photos are added separately via `createMultiImagePostPhoto` using the returned `group_id`\n\n**See also:** `updateMultiImagePost` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n---\n\n**Which endpoint to use — `data_type` family decides:**\n\nEvery post type in `data_categories` has a `data_type` field that classifies its family. Call `listPostTypes` or `getPostType` to see the `data_type` of your target post type, then choose:\n\n| `data_type` value | Family | Use endpoint |\n|---|---|---|\n| `4` | Multi-image (albums, galleries, photo-heavy listings — e.g. Classified, Photo Album, Property, Product) | `createMultiImagePost` |\n| `9` | Single-image video | `createSingleImagePost` |\n| `20` | Single-image article / event / blog / job / coupon | `createSingleImagePost` |\n| `10`, `13`, `21`, `29` (and similar) | Internal admin types (Member Listings, Reviews, Specialties, Favorites) — NOT posts | Use the resource-specific endpoint (e.g. `createReview` for `data_type=13`) |\n\nIf you call the wrong create endpoint for a given post type, BD may accept the row but it won't render on the public site correctly.\n\n**For \"make a blog post\" intent:** look up `data_categories` for `data_name` matching \"blog\" (commonly `data_id=14` with `data_type=20`) → `createSingleImagePost` with that `data_id` + `data_type`.\n\n**For \"make a photo album\" / \"gallery\" intent:** look up the album post type (often `data_id=10`, `data_type=4`) → `createMultiImagePost` with that `data_id` + `data_type`. Photos are added separately via `createMultiImagePostPhoto` using the returned `group_id`.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3592
3608
  }
3593
3609
  },
3594
3610
  "/api/v2/users_portfolio_groups/update": {
3595
3611
  "put": {
3596
- "operationId": "updatePortfolioGroup",
3612
+ "operationId": "updateMultiImagePost",
3597
3613
  "summary": "Update an album group",
3598
3614
  "tags": [
3599
3615
  "Portfolio Groups"
@@ -3642,12 +3658,12 @@
3642
3658
  }
3643
3659
  }
3644
3660
  },
3645
- "description": "Update an existing portfoliogroup record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `group_id`.\n\n**Enums:** `group_status`: `0`=Draft (saved but not publicly visible), `1`=Published (publicly visible on the site).\n\n**See also:** `createPortfolioGroup` (add new), `deletePortfolioGroup` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3661
+ "description": "Update an existing portfoliogroup record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `group_id`.\n\n**Enums:** `group_status`: `0`=Draft (saved but not publicly visible), `1`=Published (publicly visible on the site).\n\n**See also:** `createMultiImagePost` (add new), `deleteMultiImagePost` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3646
3662
  }
3647
3663
  },
3648
3664
  "/api/v2/users_portfolio_groups/delete": {
3649
3665
  "delete": {
3650
- "operationId": "deletePortfolioGroup",
3666
+ "operationId": "deleteMultiImagePost",
3651
3667
  "summary": "Delete an album group",
3652
3668
  "tags": [
3653
3669
  "Portfolio Groups"
@@ -3682,12 +3698,12 @@
3682
3698
  }
3683
3699
  }
3684
3700
  },
3685
- "description": "Permanently delete a portfoliogroup record by ID. Destructive — cannot be undone via API.\n\n**Required:** `group_id`.\n\n**See also:** `updatePortfolioGroup` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3701
+ "description": "Permanently delete a portfoliogroup record by ID. Destructive — cannot be undone via API.\n\n**Required:** `group_id`.\n\n**See also:** `updateMultiImagePost` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3686
3702
  }
3687
3703
  },
3688
3704
  "/api/v2/users_portfolio_groups/search": {
3689
3705
  "post": {
3690
- "operationId": "searchPortfolioGroups",
3706
+ "operationId": "searchMultiImagePosts",
3691
3707
  "summary": "Search album groups",
3692
3708
  "tags": [
3693
3709
  "Portfolio Groups"
@@ -3721,12 +3737,12 @@
3721
3737
  }
3722
3738
  }
3723
3739
  },
3724
- "description": "Keyword search across portfoliogroup records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` to paginate large result sets.\n\n**See also:** `getPortfolioGroup` (single record by ID), `listPortfolioGroups` (full enumeration).\n\n**Returns:** `{ status: \"success\", message: [...records] }`. Supports pagination fields when result set is large.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3740
+ "description": "Keyword search across portfoliogroup records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` to paginate large result sets.\n\n**See also:** `getMultiImagePost` (single record by ID), `listMultiImagePosts` (full enumeration).\n\n**Returns:** `{ status: \"success\", message: [...records] }`. Supports pagination fields when result set is large.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3725
3741
  }
3726
3742
  },
3727
3743
  "/api/v2/users_portfolio/get": {
3728
3744
  "get": {
3729
- "operationId": "listPortfolioPhotos",
3745
+ "operationId": "listMultiImagePostPhotos",
3730
3746
  "summary": "List album photos",
3731
3747
  "tags": [
3732
3748
  "Portfolio Photos"
@@ -3757,12 +3773,12 @@
3757
3773
  }
3758
3774
  }
3759
3775
  },
3760
- "description": "Paginated enumeration of portfoliophoto records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getPortfolioPhoto` (single record by ID).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3776
+ "description": "Paginated enumeration of portfoliophoto records. Read-only.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getMultiImagePostPhoto` (single record by ID).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3761
3777
  }
3762
3778
  },
3763
3779
  "/api/v2/users_portfolio/get/{photo_id}": {
3764
3780
  "get": {
3765
- "operationId": "getPortfolioPhoto",
3781
+ "operationId": "getMultiImagePostPhoto",
3766
3782
  "summary": "Get a single album photo",
3767
3783
  "tags": [
3768
3784
  "Portfolio Photos"
@@ -3789,12 +3805,12 @@
3789
3805
  }
3790
3806
  }
3791
3807
  },
3792
- "description": "Fetch a single portfoliophoto record. Read-only.\n\n**Required:** `photo_id`.\n\n**See also:** `listPortfolioPhotos` (enumerate many).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3808
+ "description": "Fetch a single portfoliophoto record. Read-only.\n\n**Required:** `photo_id`.\n\n**See also:** `listMultiImagePostPhotos` (enumerate many).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3793
3809
  }
3794
3810
  },
3795
3811
  "/api/v2/users_portfolio/create": {
3796
3812
  "post": {
3797
- "operationId": "createPortfolioPhoto",
3813
+ "operationId": "createMultiImagePostPhoto",
3798
3814
  "summary": "Create an album photo",
3799
3815
  "tags": [
3800
3816
  "Portfolio Photos"
@@ -3846,12 +3862,12 @@
3846
3862
  }
3847
3863
  }
3848
3864
  },
3849
- "description": "Create a new portfoliophoto record. Writes live data.\n\n**Required:** `user_id`, `group_id`.\n\n**Parameter interactions:**\n- `group_id` — parent album group (from `createPortfolioGroup` or `listPortfolioGroups`)\n- `original_image_url` — full URL of the image; must already be publicly accessible\n- `status`: `0`=Hidden, `1`=Active\n\n**See also:** `updatePortfolioPhoto` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3865
+ "description": "Create a new portfoliophoto record. Writes live data.\n\n**Required:** `user_id`, `group_id`.\n\n**Parameter interactions:**\n- `group_id` — parent album group (from `createMultiImagePost` or `listMultiImagePosts`)\n- `original_image_url` — full URL of the image; must already be publicly accessible\n- `status`: `0`=Hidden, `1`=Active\n\n**See also:** `updateMultiImagePostPhoto` (modify existing).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3850
3866
  }
3851
3867
  },
3852
3868
  "/api/v2/users_portfolio/update": {
3853
3869
  "put": {
3854
- "operationId": "updatePortfolioPhoto",
3870
+ "operationId": "updateMultiImagePostPhoto",
3855
3871
  "summary": "Update an album photo",
3856
3872
  "tags": [
3857
3873
  "Portfolio Photos"
@@ -3892,12 +3908,12 @@
3892
3908
  }
3893
3909
  }
3894
3910
  },
3895
- "description": "Update an existing portfoliophoto record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `photo_id`.\n\n**See also:** `createPortfolioPhoto` (add new), `deletePortfolioPhoto` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3911
+ "description": "Update an existing portfoliophoto record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `photo_id`.\n\n**See also:** `createMultiImagePostPhoto` (add new), `deleteMultiImagePostPhoto` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3896
3912
  }
3897
3913
  },
3898
3914
  "/api/v2/users_portfolio/delete": {
3899
3915
  "delete": {
3900
- "operationId": "deletePortfolioPhoto",
3916
+ "operationId": "deleteMultiImagePostPhoto",
3901
3917
  "summary": "Delete an album photo",
3902
3918
  "tags": [
3903
3919
  "Portfolio Photos"
@@ -3932,7 +3948,7 @@
3932
3948
  }
3933
3949
  }
3934
3950
  },
3935
- "description": "Permanently delete a portfoliophoto record by ID. Destructive — cannot be undone via API.\n\n**Required:** `photo_id`.\n\n**See also:** `updatePortfolioPhoto` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3951
+ "description": "Permanently delete a portfoliophoto record by ID. Destructive — cannot be undone via API.\n\n**Required:** `photo_id`.\n\n**See also:** `updateMultiImagePostPhoto` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
3936
3952
  }
3937
3953
  },
3938
3954
  "/api/v2/data_categories/get": {
@@ -7968,9 +7984,9 @@
7968
7984
  },
7969
7985
  "/api/v2/list_seo/get": {
7970
7986
  "get": {
7971
- "operationId": "listPages",
7987
+ "operationId": "listWebPages",
7972
7988
  "summary": "List pages (list_seo)",
7973
- "description": "Paginated list of all pages on the site: homepage, custom landing pages, profile/search templates, etc.\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`. Do not assume integer offsets.\n\n**Filter/sort:** `property` + `property_value` + `property_operator` (`=`, `LIKE`, `>`, `<`, `>=`, `<=`) to filter; `order_column` + `order_type` (`ASC`/`DESC`) to sort.\n\n**See also:** `getPage` (single record by ID).\n\n**Returns:** `{ status: \"success\", total, current_page, total_pages, next_page, prev_page, message: [...records] }`. Each record is the full resource object.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
7989
+ "description": "Paginated enumeration of web pages (`list_seo` records). Read-only.\n\nReturns every static/SEO page on the site — homepage, about, contact, custom landing pages, templates, etc. Filter by `seo_type` to get pages of a specific type (e.g., only `content` pages).\n\n**Pagination:** cursor-based. Pass `limit` (default 25, max 100) and `page` token from the previous response's `next_page`.\n\n**Filter/sort:** standard `property` / `property_value` / `property_operator`; `order_column` + `order_type`.\n\n**See also:** `getWebPage` (single by ID), `createWebPage` (new page), `updateWebPage`.\n\n**Returns:** `{ status: \"success\", total, ..., message: [...records] }`. Each record has `seo_id`, `seo_type`, `filename`, `title`, `meta_desc`, `content`, `content_active`, plus all other page fields.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
7974
7990
  "tags": [
7975
7991
  "Pages"
7976
7992
  ],
@@ -7998,7 +8014,7 @@
7998
8014
  },
7999
8015
  "/api/v2/list_seo/get/{seo_id}": {
8000
8016
  "get": {
8001
- "operationId": "getPage",
8017
+ "operationId": "getWebPage",
8002
8018
  "summary": "Get a single page",
8003
8019
  "tags": [
8004
8020
  "Pages"
@@ -8026,14 +8042,14 @@
8026
8042
  }
8027
8043
  }
8028
8044
  },
8029
- "description": "Fetch a single page record. Read-only.\n\n**Required:** `seo_id`.\n\n**See also:** `listPages` (enumerate many).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }` — the `message` array contains 1 record when found. Empty or HTTP 404 when not found.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8045
+ "description": "Fetch a single web page by `seo_id`. Read-only.\n\n**Required:** `seo_id` (path).\n\n**See also:** `listWebPages` (enumerate), `updateWebPage` (modify).\n\n**Returns:** `{ status: \"success\", message: [{...record}] }`.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8030
8046
  }
8031
8047
  },
8032
8048
  "/api/v2/list_seo/create": {
8033
8049
  "post": {
8034
- "operationId": "createPage",
8050
+ "operationId": "createWebPage",
8035
8051
  "summary": "Create a page",
8036
- "description": "Create a new page record. seo_type and filename are required. Pages are publicly accessible immediately when created with a valid seo_type and content_active=1 (default). If the user asks for a \"landing page\", \"static page\", \"about page\", \"contact page\", \"custom page\", or similar, use seo_type=\"content\" — that is the BD admin default for generic pages. Only choose a different seo_type if the user explicitly asks for a search-results template, password-retrieval page, unsubscribe page, or custom-widget page.\n\n**Required:** `seo_type`, `filename`.\n\n**Enums:** `content_layout`: `0`, `1`; `menu_layout`: `1`, `2`, `3`, `4`; `show_form`: `0`=No, `1`=Yes; `hide_from_menu`: `0`=No, `1`=Yes; `hide_header_links`: `0`, `1`; `hide_header`: `0`, `1`.\n\n**Parameter interactions:**\n- `seo_type` — required, must be one of the fixed admin-UI values (invalid types cause unrenderable records). `home` = homepage replacement\n- `filename` — URL slug (e.g. `about-us`), not the full URL\n- `content_active=1` (default) + valid `seo_type` = page is publicly accessible IMMEDIATELY — no admin action needed\n- `content` supports `[widget=Name]` shortcodes and template tokens (e.g. `%%%website_name%%%`, `%%Profession%%`)\n\n**See also:** `updatePage` (modify existing).\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` — includes the server-assigned ID (e.g., `user_id`, `post_id`). Use this ID for follow-up operations.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
8052
+ "description": "Create a new web page on the site. Writes live data.\n\nA WebPage is any static-ish page: the homepage (`seo_type=home`), about, contact, custom landing pages, category templates, profile templates, and search result templates. Backed by BD's `list_seo` table.\n\nPages are publicly accessible **immediately** once `content_active=1` (the default) and a valid `seo_type` is supplied — no admin action needed.\n\n**Required:** `seo_type`, `filename`.\n\n**Parameter guidance:**\n- `seo_type` — page type identifier. Must be one of the fixed admin-UI values (invalid types produce unrenderable records). Common values: `home` (homepage replacement), `content` (generic static/landing page — BD admin default for \"new page\"), profile/search template types, etc. For a generic landing/static page, use `content`.\n- `filename` — URL slug (e.g. `about-us`), not the full URL. The public URL is `<site-domain>/<filename>`.\n- `content` — main HTML body. Supports `[widget=Name]` shortcodes AND template tokens.\n- `content_active=1` (default) — page is live; `0` = hidden.\n\n**See also:** `listWebPages` (enumerate), `updateWebPage` (modify), `createRedirect` (if replacing an existing URL, create a 301 to preserve SEO).\n\n**Writes live data:** changes are immediately visible on the public site.\n\n**Returns:** `{ status: \"success\", message: {...createdRecord} }` including `seo_id`.\n\n\n**BD Admin UI — field label mapping:**\n\nSome field names are opaque; this is what they're called in the BD admin page-settings screens.\n\n*Display/layout toggles (integer 0/1 unless noted):*\n| Field | Admin UI label |\n|---|---|\n| `content_layout` | Full Screen Page Width |\n| `section` | Hide Banner Ad Modules |\n| `hide_header` | Hide Header |\n| `hide_footer` | Hide Footer |\n| `hide_top_right` | Hide Top Header Menu |\n| `hide_header_links` | Hide Main Menu |\n| `content_images` | Click-Enlarge Images (value: `click_to_enlarge` to enable) |\n| `show_form` | **Apply NoIndex, NoFollow** (NOT a contact-form toggle — BD repurposed this column) |\n| `disable_css_stylesheets` | Disable Default CSS Stylesheets |\n| `disable_preview_screenshot` | Disable Screenshot Preview |\n| `seo_text` | Wildcard URL Rewrite (catch-all routing) |\n\n*SEO / meta:*\n| Field | Admin UI label |\n|---|---|\n| `title` | Page Meta Title |\n| `meta_desc` | Meta Description |\n| `meta_keywords` | Meta Keywords |\n| `h1` | H1 Heading |\n| `h2` | H2 Heading |\n\n*Social (Open Graph):*\n| Field | Admin UI label |\n|---|---|\n| `facebook_title` | Social Media Title |\n| `facebook_desc` | Social Media Description |\n| `facebook_image` | Social Media Shared Image (≥200×200px) |\n\nTemplate tokens: `title`, `meta_desc`, `meta_keywords`, `h1`, `h2` all support `%%%website_name%%%`, `%industry%`, `%profession%` (expanded at render time).\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
8037
8053
  "tags": [
8038
8054
  "Pages"
8039
8055
  ],
@@ -8070,27 +8086,27 @@
8070
8086
  },
8071
8087
  "title": {
8072
8088
  "type": "string",
8073
- "description": "HTML title tag — supports template tokens like %%%website_name%%%"
8089
+ "description": "**Page Meta Title** — Supports template tokens: `%%%website_name%%%`, `%industry%`, `%profession%`, etc. ~30-60 chars recommended. HTML title tag — supports template tokens like %%%website_name%%%"
8074
8090
  },
8075
8091
  "meta_keywords": {
8076
8092
  "type": "string",
8077
- "description": "Meta keywords — supports template tokens"
8093
+ "description": "**Meta Keywords** — Supports template tokens (comma-separated). Meta keywords — supports template tokens"
8078
8094
  },
8079
8095
  "meta_desc": {
8080
8096
  "type": "string",
8081
- "description": "Meta description — supports template tokens"
8097
+ "description": "**Meta Description** — Supports template tokens. ~150-160 chars recommended for search snippets. Meta description — supports template tokens"
8082
8098
  },
8083
8099
  "seo_text": {
8084
8100
  "type": "string",
8085
- "description": "Additional SEO body text rendered on page"
8101
+ "description": "**Wildcard URL Rewrite** — 1 = any URL within this directory routes to this web page (catch-all behavior)."
8086
8102
  },
8087
8103
  "h1": {
8088
8104
  "type": "string",
8089
- "description": "H1 heading — supports template tokens"
8105
+ "description": "**H1 Heading** — Supports template tokens. Rendered as the page's main heading. H1 heading — supports template tokens"
8090
8106
  },
8091
8107
  "h2": {
8092
8108
  "type": "string",
8093
- "description": "H2 heading — supports template tokens"
8109
+ "description": "**H2 Heading** — Supports template tokens. H2 heading — supports template tokens"
8094
8110
  },
8095
8111
  "breadcrumb": {
8096
8112
  "type": "string",
@@ -8130,7 +8146,7 @@
8130
8146
  0,
8131
8147
  1
8132
8148
  ],
8133
- "description": "Full-screen page width toggle (integer boolean).\\n 1 = Full Screen Page Width (page content spans the full viewport width, no side margins)\\n 0 = Standard width (default — page content is constrained to the site theme's content column)\\nIn BD admin this is a single checkbox. Pass 1 to enable, 0 to disable. If unsure, omit the field and the default will apply."
8149
+ "description": "**Full Screen Page Width** — 1 = expand content edge-to-edge; 0 = default (contained) width."
8134
8150
  },
8135
8151
  "content_sidebar": {
8136
8152
  "type": "string",
@@ -8152,7 +8168,7 @@
8152
8168
  0,
8153
8169
  1
8154
8170
  ],
8155
- "description": "1 = show contact form"
8171
+ "description": "**Apply NoIndex, NoFollow** — 1 = adds `<meta name=\"robots\" content=\"noindex,nofollow\">` to the page. Auto-applied to protected pages. NOT a contact-form toggle (despite the field name — BD repurposed this column)."
8156
8172
  },
8157
8173
  "form_name": {
8158
8174
  "type": "string",
@@ -8172,7 +8188,7 @@
8172
8188
  0,
8173
8189
  1
8174
8190
  ],
8175
- "description": "1 = hide header navigation links"
8191
+ "description": "**Hide Main Menu** — 1 = hides the main navigation menu on this page."
8176
8192
  },
8177
8193
  "hide_header": {
8178
8194
  "type": "integer",
@@ -8180,7 +8196,7 @@
8180
8196
  0,
8181
8197
  1
8182
8198
  ],
8183
- "description": "1 = hide site header"
8199
+ "description": "**Hide Header** — 1 = hides the full site header on this page."
8184
8200
  },
8185
8201
  "hide_footer": {
8186
8202
  "type": "integer",
@@ -8188,7 +8204,7 @@
8188
8204
  0,
8189
8205
  1
8190
8206
  ],
8191
- "description": "1 = hide site footer"
8207
+ "description": "**Hide Footer** — 1 = hides the site footer on this page."
8192
8208
  },
8193
8209
  "hide_top_right": {
8194
8210
  "type": "integer",
@@ -8196,19 +8212,19 @@
8196
8212
  0,
8197
8213
  1
8198
8214
  ],
8199
- "description": "1 = hide top-right header area"
8215
+ "description": "**Hide Top Header Menu** — 1 = hides the top-right nav cluster (account/login links)."
8200
8216
  },
8201
8217
  "facebook_title": {
8202
8218
  "type": "string",
8203
- "description": "Open Graph title for social sharing"
8219
+ "description": "**Social Media Title (Open Graph)** — Title shown when the page is shared on Facebook/LinkedIn/etc. Open Graph title for social sharing"
8204
8220
  },
8205
8221
  "facebook_desc": {
8206
8222
  "type": "string",
8207
- "description": "Open Graph description"
8223
+ "description": "**Social Media Description (Open Graph)** — Description shown on social shares. Open Graph description"
8208
8224
  },
8209
8225
  "facebook_image": {
8210
8226
  "type": "string",
8211
- "description": "Open Graph image URL"
8227
+ "description": "**Social Media Shared Image** — URL/filename of the OG image. BD recommends at least 200×200px. Open Graph image URL"
8212
8228
  },
8213
8229
  "org_template": {
8214
8230
  "type": "integer",
@@ -8292,7 +8308,7 @@
8292
8308
  },
8293
8309
  "/api/v2/list_seo/update": {
8294
8310
  "put": {
8295
- "operationId": "updatePage",
8311
+ "operationId": "updateWebPage",
8296
8312
  "summary": "Update a page",
8297
8313
  "tags": [
8298
8314
  "Pages"
@@ -8333,27 +8349,27 @@
8333
8349
  },
8334
8350
  "title": {
8335
8351
  "type": "string",
8336
- "description": "HTML title tag — supports template tokens like %%%website_name%%%"
8352
+ "description": "**Page Meta Title** — Supports template tokens: `%%%website_name%%%`, `%industry%`, `%profession%`, etc. ~30-60 chars recommended. HTML title tag — supports template tokens like %%%website_name%%%"
8337
8353
  },
8338
8354
  "meta_keywords": {
8339
8355
  "type": "string",
8340
- "description": "Meta keywords — supports template tokens"
8356
+ "description": "**Meta Keywords** — Supports template tokens (comma-separated). Meta keywords — supports template tokens"
8341
8357
  },
8342
8358
  "meta_desc": {
8343
8359
  "type": "string",
8344
- "description": "Meta description — supports template tokens"
8360
+ "description": "**Meta Description** — Supports template tokens. ~150-160 chars recommended for search snippets. Meta description — supports template tokens"
8345
8361
  },
8346
8362
  "seo_text": {
8347
8363
  "type": "string",
8348
- "description": "Additional SEO body text rendered on page"
8364
+ "description": "**Wildcard URL Rewrite** — 1 = any URL within this directory routes to this web page (catch-all behavior)."
8349
8365
  },
8350
8366
  "h1": {
8351
8367
  "type": "string",
8352
- "description": "H1 heading — supports template tokens"
8368
+ "description": "**H1 Heading** — Supports template tokens. Rendered as the page's main heading. H1 heading — supports template tokens"
8353
8369
  },
8354
8370
  "h2": {
8355
8371
  "type": "string",
8356
- "description": "H2 heading — supports template tokens"
8372
+ "description": "**H2 Heading** — Supports template tokens. H2 heading — supports template tokens"
8357
8373
  },
8358
8374
  "breadcrumb": {
8359
8375
  "type": "string",
@@ -8393,7 +8409,7 @@
8393
8409
  0,
8394
8410
  1
8395
8411
  ],
8396
- "description": "Full-screen page width toggle (integer boolean).\\n 1 = Full Screen Page Width (page content spans the full viewport width, no side margins)\\n 0 = Standard width (default — page content is constrained to the site theme's content column)\\nIn BD admin this is a single checkbox. Pass 1 to enable, 0 to disable. If unsure, omit the field and the default will apply."
8412
+ "description": "**Full Screen Page Width** — 1 = expand content edge-to-edge; 0 = default (contained) width."
8397
8413
  },
8398
8414
  "content_sidebar": {
8399
8415
  "type": "string",
@@ -8415,7 +8431,7 @@
8415
8431
  0,
8416
8432
  1
8417
8433
  ],
8418
- "description": "1 = show contact form"
8434
+ "description": "**Apply NoIndex, NoFollow** — 1 = adds `<meta name=\"robots\" content=\"noindex,nofollow\">` to the page. Auto-applied to protected pages. NOT a contact-form toggle (despite the field name — BD repurposed this column)."
8419
8435
  },
8420
8436
  "form_name": {
8421
8437
  "type": "string",
@@ -8435,7 +8451,7 @@
8435
8451
  0,
8436
8452
  1
8437
8453
  ],
8438
- "description": "1 = hide header navigation links"
8454
+ "description": "**Hide Main Menu** — 1 = hides the main navigation menu on this page."
8439
8455
  },
8440
8456
  "hide_header": {
8441
8457
  "type": "integer",
@@ -8443,7 +8459,7 @@
8443
8459
  0,
8444
8460
  1
8445
8461
  ],
8446
- "description": "1 = hide site header"
8462
+ "description": "**Hide Header** — 1 = hides the full site header on this page."
8447
8463
  },
8448
8464
  "hide_footer": {
8449
8465
  "type": "integer",
@@ -8451,7 +8467,7 @@
8451
8467
  0,
8452
8468
  1
8453
8469
  ],
8454
- "description": "1 = hide site footer"
8470
+ "description": "**Hide Footer** — 1 = hides the site footer on this page."
8455
8471
  },
8456
8472
  "hide_top_right": {
8457
8473
  "type": "integer",
@@ -8459,19 +8475,19 @@
8459
8475
  0,
8460
8476
  1
8461
8477
  ],
8462
- "description": "1 = hide top-right header area"
8478
+ "description": "**Hide Top Header Menu** — 1 = hides the top-right nav cluster (account/login links)."
8463
8479
  },
8464
8480
  "facebook_title": {
8465
8481
  "type": "string",
8466
- "description": "Open Graph title for social sharing"
8482
+ "description": "**Social Media Title (Open Graph)** — Title shown when the page is shared on Facebook/LinkedIn/etc. Open Graph title for social sharing"
8467
8483
  },
8468
8484
  "facebook_desc": {
8469
8485
  "type": "string",
8470
- "description": "Open Graph description"
8486
+ "description": "**Social Media Description (Open Graph)** — Description shown on social shares. Open Graph description"
8471
8487
  },
8472
8488
  "facebook_image": {
8473
8489
  "type": "string",
8474
- "description": "Open Graph image URL"
8490
+ "description": "**Social Media Shared Image** — URL/filename of the OG image. BD recommends at least 200×200px. Open Graph image URL"
8475
8491
  },
8476
8492
  "org_template": {
8477
8493
  "type": "integer",
@@ -8551,12 +8567,12 @@
8551
8567
  }
8552
8568
  }
8553
8569
  },
8554
- "description": "Update an existing page record by ID. Fields omitted are untouched. Writes live data.\n\n**Required:** `seo_id`.\n\n**Enums:** `seo_type`: `content`, `data_category`, `profile_search_results`, `custom_widget_page`, `password_retrieval_page`, `unsubscribed`; `content_layout`: `0`, `1`; `menu_layout`: `1`, `2`, `3`, `4`; `show_form`: `0`=No, `1`=Yes; `hide_from_menu`: `0`=No, `1`=Yes; `hide_header_links`: `0`, `1`; `hide_header`: `0`, `1`.\n\n**Parameter interactions:**\n- `content` supports `[widget=Name]` shortcodes and template tokens like `%%%website_name%%%`\n- `content_active=1` makes the page live; `content_active=0` hides it from public without deleting\n\n**See also:** `createPage` (add new), `deletePage` (remove permanently).\n\n**Writes live data:** confirm intent with the user for bulk operations. Changes are immediately visible on the live site.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }` — the full updated record after changes applied.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8570
+ "description": "Update an existing web page by `seo_id`. Fields omitted are untouched. Writes live data.\n\nChanges go live immediately. No cache refresh needed for most edits. If changing `filename` (URL slug), consider creating a 301 via `createRedirect` so inbound links to the old slug keep working.\n\n**Required:** `seo_id`.\n\n**Common edits:**\n- Copy/content: `content`, `h1`, `h2`, `seo_text`, `content_footer`\n- SEO: `title`, `meta_desc`, `meta_keywords`\n- Social: `facebook_title`, `facebook_desc`, `facebook_image`\n- Layout: `content_layout`, `hide_header`, `hide_footer`, etc. (see mapping below)\n- Visibility: `content_active` (1 = live, 0 = hidden)\n\n**See also:** `createWebPage` (add new), `deleteWebPage` (remove), `createRedirect` (after slug changes).\n\n**Writes live data:** immediately visible.\n\n**Returns:** `{ status: \"success\", message: {...updatedRecord} }`.\n\n\n**BD Admin UI — field label mapping:**\n\nSome field names are opaque; this is what they're called in the BD admin page-settings screens.\n\n*Display/layout toggles (integer 0/1 unless noted):*\n| Field | Admin UI label |\n|---|---|\n| `content_layout` | Full Screen Page Width |\n| `section` | Hide Banner Ad Modules |\n| `hide_header` | Hide Header |\n| `hide_footer` | Hide Footer |\n| `hide_top_right` | Hide Top Header Menu |\n| `hide_header_links` | Hide Main Menu |\n| `content_images` | Click-Enlarge Images (value: `click_to_enlarge` to enable) |\n| `show_form` | **Apply NoIndex, NoFollow** (NOT a contact-form toggle — BD repurposed this column) |\n| `disable_css_stylesheets` | Disable Default CSS Stylesheets |\n| `disable_preview_screenshot` | Disable Screenshot Preview |\n| `seo_text` | Wildcard URL Rewrite (catch-all routing) |\n\n*SEO / meta:*\n| Field | Admin UI label |\n|---|---|\n| `title` | Page Meta Title |\n| `meta_desc` | Meta Description |\n| `meta_keywords` | Meta Keywords |\n| `h1` | H1 Heading |\n| `h2` | H2 Heading |\n\n*Social (Open Graph):*\n| Field | Admin UI label |\n|---|---|\n| `facebook_title` | Social Media Title |\n| `facebook_desc` | Social Media Description |\n| `facebook_image` | Social Media Shared Image (≥200×200px) |\n\nTemplate tokens: `title`, `meta_desc`, `meta_keywords`, `h1`, `h2` all support `%%%website_name%%%`, `%industry%`, `%profession%` (expanded at render time).\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8555
8571
  }
8556
8572
  },
8557
8573
  "/api/v2/list_seo/delete": {
8558
8574
  "delete": {
8559
- "operationId": "deletePage",
8575
+ "operationId": "deleteWebPage",
8560
8576
  "summary": "Delete a page",
8561
8577
  "tags": [
8562
8578
  "Pages"
@@ -8592,7 +8608,7 @@
8592
8608
  }
8593
8609
  }
8594
8610
  },
8595
- "description": "Permanently delete a page record by ID. Destructive — cannot be undone via API.\n\n**Required:** `seo_id`.\n\n**See also:** `updatePage` (modify without removing).\n\n**Destructive:** confirm intent with the user before bulk use. No soft-delete via API — records removed are not recoverable.\n\n**Returns:** `{ status: \"success\", message: \"record was deleted\" }`. No body beyond the confirmation string.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8611
+ "description": "Permanently delete a web page by `seo_id`. Destructive — cannot be undone via API.\n\n**Required:** `seo_id`.\n\n**Destructive:** confirm with the user. If inbound links or menus reference the deleted page's URL, consider creating a `createRedirect` BEFORE deleting so those links don't 404. Menus with items pointing at this page also need cleanup.\n\n**See also:** `updateWebPage` with `content_active=0` (hide without deleting — safer for reversible actions).\n\n**Returns:** `{ status: \"success\", message: \"list_seo record was deleted\" }`.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._"
8596
8612
  }
8597
8613
  },
8598
8614
  "/api/v2/redirect_301/get": {
@@ -8823,7 +8839,7 @@
8823
8839
  "post": {
8824
8840
  "operationId": "refreshSiteCache",
8825
8841
  "summary": "Refresh the site cache",
8826
- "description": "Clears BD's internal caches for the site. IMPORTANT: this does NOT register newly-created page URLs with the router — a freshly created page via createPage will still 404 on the public site even after refreshCache. The only known way to fully activate a new page is manually clicking Save on the record in BD Admin > Manage Pages. This endpoint is useful for generic cache invalidation (e.g., after changes to templates, design settings, etc.), not for page propagation. Undocumented by BD publicly; exposed via admin API-permissions UI.\n\n**Parameter interactions:**\n- Clears BD's internal caches. Does NOT register newly-created page URLs with the public router (new pages created via `createPage` become live immediately via `content_active=1` + valid `seo_type`, not via this endpoint)\n\n**Returns:** `{ status: \"success\"|\"error\", message: ... }` — BD's standard response envelope.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
8842
+ "description": "Clears BD's internal caches for the site. IMPORTANT: this does NOT register newly-created page URLs with the router — a freshly created page via createWebPage will still 404 on the public site even after refreshCache. The only known way to fully activate a new page is manually clicking Save on the record in BD Admin > Manage Pages. This endpoint is useful for generic cache invalidation (e.g., after changes to templates, design settings, etc.), not for page propagation. Undocumented by BD publicly; exposed via admin API-permissions UI.\n\n**Parameter interactions:**\n- Clears BD's internal caches. Does NOT register newly-created page URLs with the public router (new pages created via `createWebPage` become live immediately via `content_active=1` + valid `seo_type`, not via this endpoint)\n\n**Returns:** `{ status: \"success\"|\"error\", message: ... }` — BD's standard response envelope.\n\n_Auth: `X-Api-Key` header. Rate limit: 100 req/60s (on 429, back off 60s). Errors: `{ \"status\": \"error\", \"message\": \"...\" }` with standard HTTP codes._",
8827
8843
  "tags": [
8828
8844
  "Website Settings"
8829
8845
  ],
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "brilliant-directories-mcp",
3
3
  "mcpName": "io.github.brilliantdirectories/brilliant-directories-mcp",
4
- "version": "3.0.0",
4
+ "version": "5.0.0",
5
5
  "description": "Official MCP server for Brilliant Directories — manage members, posts, leads, reviews, and more.",
6
6
  "main": "index.js",
7
7
  "bin": {