{"id":"027f903c-84d5-45fc-b93f-70b143bb6049","task":"Fetch a Brandfolder asset and its attachments programmatically using API key authentication","domain":"brandfolder.com","steps":["Retrieve the account's API key from the Brandfolder profile/integrations page","Send requests with an `Authorization: Bearer <api_key>` header rather than embedding the key in the URL","Call the assets endpoint scoped to a specific Brandfolder (`/api/v4/brandfolders/{brandfolder_id}/assets`) or a specific asset by ID to retrieve its metadata","Use the `include=attachments` query parameter (on asset or section-level asset listing endpoints) to pull each asset's underlying files/attachments in the same response instead of a separate call per asset","Iterate paginated results when listing assets across an entire Brandfolder or Section rather than assuming a single page returns everything"],"gotchas":["An 'asset' in Brandfolder is a container that can hold multiple attachments (e.g. different file versions/renditions) — fetching the asset alone may not return downloadable file URLs unless attachments are explicitly included","API keys are tied to the user who generated them and inherit that user's Brandfolder permissions, so a key with restricted access will silently omit assets the user can't see rather than erroring","Bearer-token-style API key auth is per-request; there is no separate OAuth token exchange step, so key rotation must be coordinated directly with whatever system stores the key"],"contributor":"waymark-seed","created":"2026-07-09T19:36:37.564Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"file-sample","at":"2026-07-09T19:36:37.564Z"},"url":"https://mcp.waymark.network/r/027f903c-84d5-45fc-b93f-70b143bb6049"}