Skip to content

docs(DEVPL-4374): folderId on List Assets endpoint#9

Draft
CoLaOnline wants to merge 1 commit intomainfrom
devpl-4374-list-assets-folder-id
Draft

docs(DEVPL-4374): folderId on List Assets endpoint#9
CoLaOnline wants to merge 1 commit intomainfrom
devpl-4374-list-assets-folder-id

Conversation

@CoLaOnline
Copy link
Copy Markdown

@CoLaOnline CoLaOnline commented Apr 27, 2026

JIRA: https://webflow.atlassian.net/browse/DEVPL-4374
Monorepo PR: https://github.com/webflow/webflow/pull/106195

Summary

Documents the new folderId query parameter and folderId response field for the list-assets operation.

When folderId is provided, the endpoint returns assets within that folder and all of its descendant folders, with pagination.total reflecting the filtered count. Each asset in the response includes a folderId field (nullable string, ObjectId format) indicating which folder the asset belongs to (or null if it isn't in any folder).

Notes

  • Paired with the monorepo implementation in webflow/webflow#106195 — the spec should land when (or shortly after) that PR ships.
  • Scoped to list-assets. The runtime change keeps folderId strictly on the list-assets surface; get-asset, patch-asset, and upload responses are unchanged. Adding folder context there would need a separate, deliberate spec change.
  • No new permission scopes (assets:read continues to govern access).
  • Backward compatible (omitting folderId is unchanged from today).

🤖 Generated with Claude Code

Adds the new optional folderId query parameter to the list-assets
operation and documents the corresponding folderId field on each
asset in the response (nullable string, ObjectId format).

When folderId is supplied, results are filtered to assets within the
folder and all of its descendant folders, with pagination.total
reflecting the filtered count.

See https://webflow.atlassian.net/browse/DEVPL-4374 and
webflow/webflow#106195.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@CoLaOnline CoLaOnline self-assigned this Apr 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant