Skip to content

Collections

A Collection is a user defined set of Asset resources.

The Asset resources in a Collection are not returned with the Collection resource. To get the Asset resources you must create an Asset Search and use the Collection.id as the value in a COLLECTIONS : FIELD_EQUALS criterion.

Searching allows you to find Collection resources in your Dash matching specific criteria.

A list of sorts can also be provided to control the order in the which the results are returned.

Operations

Create a collection

Request

Create a new Collection.

Security
bearerToken
Bodyapplication/jsonrequired
namestringrequired

Name of the Collection

Example:"Folders"
curl -i -X POST \
  https://api-v2.dash.app/collections \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Folders"
  }'

Responses

Success

Bodyapplication/json
resultobjectrequired
permittedActionsArray of objectsrequired
Response
{
  "result": {
    "id": "a52b5315-15b8-417f-b742-d6902108bac1",
    "accountId": "cfb665ca-ce35-4418-b9d5-70ee815db4bd",
    "name": "Folders",
    "creatorId": "google-oauth2|110955770826801837334",
    "dateCreated": "2021-02-17T09:24:01.417Z",
    "collaborators": [ … ],
    "share": { … }
  },
  "permittedActions": [
    { … }
  ]
}