SMsmartsheet
collections

Fetch a collection

Returns the matching collection.

get/collections/{collection_id}

Request

  • Base URL
    https://brandfolder.com/api/v4
  • Auth
    HTTP bearer

Query parameters

fields'asset_count'

Set it to asset_count to return the collection's asset count as part of the collection's attributes in the response.

WARNING: This parameter can slow response times.

includestring

Set it to a comma-separated list (no spaces) of any of the following record names to return those records related to the collection you're fetching. Related records are returned in an included array in the response.

Allowed values:

  • brandfolder
  • assets
  • search_filters

WARNING: This parameter can slow response times.

Headers

Accept'application/json' required

Response

The matching collection.

Example response

{
  "data": {
    "id": "oqgkkd-fr5iv4-hh142d",
    "attributes": {
      "name": "My collection",
      "tagline": "My collection tag line",
      "slug": "my-collection"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.