Creates a new personal collection associated with the holder of the API key specified in the Authorization header, using the attributes specified in the request body.

Query parameters

None

Body parameters

NameTypeDescriptionDefaultRequired?
bookmarks array An array of bookmarks, each representing a dataset or collection1. true
description string Long description of this personal collection. false
display_name string Name of this personal collection. true

1 See the format shown on the PersonalCollection model.

Responses

CodeReturns
201 The personal collection model for the new personal collection.
430 Invalid request data

Example

This example creates a new empty personal collection called “Test.”

Request

$ curl -X POST 'https://public.enigma.com/api/personal-collections/' -H 'Authorization: Bearer <APIKEY>' -H 'Content-Type: application/json' \
    -d '{"display_name": "Test", "description": "Test", "bookmarks": []}'

Response

{
  "bookmarks": [],
  "description": "Test",
  "display_name": "Test",
  "id": "9dec848b-b342-40f3-918c-0ebfa36de08a",
  "published": true
}