getMultiImagePost
Fetch a multi-image post (album) by its group ID. Returns a lean record with photo count and cover URL; use optional flags to include full content, author, photos, or extras.
Instructions
Get a single album group - Fetch a single portfoliogroup record. Read-only.
Lean-by-default keep-list: same shape as listMultiImagePosts — core identity + routing fields plus total_clicks (only when > 0), total_photos, cover_photo_url, cover_thumbnail_url. Restore via flags: include_content=1 (full group_desc HTML), include_author_full=1 (full user nested — default omits author detail; call getUser(user_id) otherwise), include_clicks=1, include_photos=1 (full users_portfolio photo array), include_extras=1 (everything else — geo, post dates, timestamps, tokens, etc.).
Use when: fetching one multi-image post by group_id. Photos in this post are loaded separately via listMultiImagePostPhotos with group_id filter.
Required: group_id.
See also: listMultiImagePosts (enumerate many; supports keyword filter via property + property_operator=LIKE).
Returns: { status: "success", message: [{...record}] } - the message array contains 1 lean-shaped record when found. Empty or HTTP 404 when not found.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| group_id | Yes | ||
| include_content | No | Opt in to return the full `post_content` HTML body. Default stripped (`post_title` + `post_caption` always returned). | |
| include_author_full | No | Opt in to return the full original `user` nested object (every field BD returns, including `password` hash, session `token`, `cookie`). Default: author detail omitted entirely — call `getUser(user_id)` when needed. | |
| include_clicks | No | Opt in to return `user_clicks_schema.clicks` array. Default: `total_clicks` count surfaced only when > 0; absent means zero clicks. | |
| include_photos | No | Opt in to return `photos_schema` array. Default: `total_photos` count only (`image_main_file` URL always returned). | |
| include_extras | No | Opt in to return ALL remaining fields on this resource that are not in the lean-by-default keep-list and not gated by another `include_*` flag. Lean default returns only the core identity, routing, and load-bearing fields. `include_extras=1` restores everything else (geo, all hero_*, layout/sidebar/menu config, all display toggles, admin metadata, etc.). Resource-specific — see each tool's description for what the extras bundle contains. |