feat(web-api): add support for parent_id parameter to bookmarks.list method

[markfoden]

Package

@slack/web-api

Question

I'm trying to build an app that dynamically writes bookmark links to specific folders. Whilst bookmarks.add does indicate it's possible to specify a parent_id it looks like bookmarks.list doesn't expose them (see result below).

Is that right or am I missing something? If I am is there a plan to expose these ids sometime?

Thanks, Mark

@filmaj - you were very helpful a couple of years ago - If this is in your bailiwick would you take a look? Thanks

{"message":"Bookmark debug list","channel_id":"C0A2","count":2,"bookmarks":[{"id":"Bk0ANJFDG10X","title":"My link","type":"link","parent_id":"","link":"https://bramblegroup.slack.com/archives/C01SL.../p1774438786797799"},{"id":"Bk0APD1DUV5X","title":"Another Link","type":"link","parent_id":"","link":"https://bramblegroup.slack.com/archives/C01SL.../p1774438786797799"}]}

SDK Version

No response

Node.js Version

No response

Additional Context

No response

[filmaj]

Sorry, I left Slack a couple of years ago, not sure. Good luck!

[mwbrooks]

Hey @markfoden 👋🏻 (and @filmaj 🤙🏻)

I've taken a look at the Slack API implementation and I don't think you're missing anything. The API Spec looks as though it planned to expose the parent_id for every bookmark item, but it's not set by the bookmarks.list method.

I'll share this question internally with the broader Slack API team and try to learn whether this was a product-design (or security) decision, or whether it's a missing feature.

If it's a missing feature, we may be able to usher this one forward for you. 🚢 💨

I'll let you know what I hear back! If you find this issue goes a while without a response, please don't hesitate to nudge me.

[mwbrooks]

Hey @markfoden, I just poked around a bit here and bookmarks.list returns the parent_id for a bookmark that is stored under a folder - for me.

Request:

POST https://slack.com/api/bookmarks.list?channel_id=C0123

Response:

{
    "ok": true,
    "bookmarks": [
        {
            "id": "Bk0123",
            "channel_id": "C0123",
            "title": "https://michaelbrooks.ca",
            "link": "https://michaelbrooks.ca",
            "emoji": null,
            "icon_url": "https://michaelbrooks.ca/favicon.ico",
            "type": "link",
            "entity_id": null,
            "date_created": 1774846423,
            "date_updated": 0,
            "rank": "U",
            "last_updated_by_user_id": "",
            "last_updated_by_team_id": "",
            "shortcut_id": "",
            "app_id": "",
            "app_action_id": "",
            "image_url": "https://michaelbrooks.ca/favicon.ico",
            "date_create": 1774846423,
            "date_update": 0,
            "parent_id": "Bk0123"
        }
    ]
}

Screenshot:

[markfoden]

@mwbrooks Thanks for doing this. I've run it again myself, this time outputting the entire response. The parent_id is not in it. Any ideas?

const slackClient = new WebClient(slackToken);
    const listResponse = await slackClient.bookmarks.list({
      channel_id: channelId,
    });
    const bookmarks = (listResponse.bookmarks || []) as BookmarkItem[];

    if (action === ACTION_DEBUG_LIST_BOOKMARKS) {
      return {
        statusCode: 200,
        body: jsonBody({
          message: "Bookmark debug list",
          channel_id: channelId,
          ...listResponse,
        }),
      };
    }

{
  "message": "Bookmark debug list",
  "channel_id": "C0A23EZBNKF",
  "ok": true,
  "bookmarks": [
    {
      "id": "Bk0ANJFDG10X",
      "channel_id": "C0A23...",
      "title": "Portsmouth City Council ~ 2026-03-25 Adult Social Care Case Management System",
      "link": "https://bramblegroup.slack.com/archives/C01SL.../p1774438786797799",
      "emoji": null,
      "icon_url": null,
      "type": "link",
      "entity_id": null,
      "date_created": 1774514742,
      "date_updated": 0,
      "rank": "U",
      "last_updated_by_user_id": "",
      "last_updated_by_team_id": "",
      "shortcut_id": "",
      "app_id": "",
      "app_action_id": ""
    },
    {
      "id": "Bk0APD1DUV5X",
      "channel_id": "C0A23...",
      "title": "Another Link",
      "link": "https://bramblegroup.slack.com/archives/C01SL.../p1774438786797799",
      "emoji": null,
      "icon_url": null,
      "type": "link",
      "entity_id": null,
      "date_created": 1774516234,
      "date_updated": 0,
      "rank": "U",
      "last_updated_by_user_id": "",
      "last_updated_by_team_id": "",
      "shortcut_id": "",
      "app_id": "",
      "app_action_id": ""
    }
  ],
  "response_metadata": {
    "scopes": [
      "commands",
      "chat:write",
      "pins:write",
      "channels:history",
      "channels:read",
      "groups:read",
      "mpim:read",
      "im:write",
      "chat:write.public",
      "im:read",
      "channels:manage",
      "groups:write",
      "mpim:write",
      "usergroups:read",
      "files:write",
      "bookmarks:read",
      "bookmarks:write",
      "channels:join",
      "canvases:write"
    ],
    "acceptedScopes": [
      "bookmarks:read"
    ]
  }
}```

[markfoden]

@mwbrooks You said to nudge you: any thoughts on this? ☝️

[markfoden]

@mwbrooks please forgive re-nudge ☝️

[github-actions]

👋 It looks like this issue has been open for 30 days with no activity. We'll mark this as stale for now, and wait 10 days for an update or for further comment before closing this issue out. If you think this issue needs to be prioritized, please comment to get the thread going again! Maintainers also review issues marked as stale on a regular basis and comment or adjust status if the issue needs to be reprioritized.