LUlucid
Collection

Update Collection

This endpoint takes a JSON object and uses it to update the collection's name and/or data source. The JSON object of the updated collection is returned. Updates will only occur if the user has access to the data source. Only top level collections can be updated. Metadata collections cannot be updated.

patch/collections/{collectionId}

Request

  • Base URL
    https://data.lucid.app
  • URL
    https://data.lucid.app/collections/{collectionId}
  • Auth
    OAuth 2
    Authorization code: https://lucid.app/oauth2/authorize
    Token URL: https://api.lucid.co/oauth2/token scopes: data-service.admin

Path parameters

collectionIdinteger required

ID of collection to update

Request body

dataSourcestring

URI of data source to move collection to

namestring

New name for the collection

Example request

{
  "dataSource": "https://data.lucid.app/dataSources/12",
  "name": "Updated Collection Name"
}

Response

OK with Collection

uristring required

URI of the collection

dataSourcestring required

Link to get parent data source

namestring required

Name of the collection

lastSyncstring required

Date the collection was last synced with upstream source

versionTimestampstring required

Timestamp of the last time the collection, the collection's schema, the collection's contents, one of its collection properties, or anything in any of its metadata collections was changed. It can be used to tell if a copy of the data is out of date and needs to be refreshed.

createdstring required

Date the collection was created

lastModifiedstring required

Date the collection was last modified

itemsstring required

Link to get items in the collection

schemastring required

Link to get schema for the collection

propertiesstring required

Link to get properties for the collection

metadatastring required

Link to get metadata for the collection

metadataTypestring

If a metadata collection, this specifies what tyep of metadata it contains

parentstring

If a metadata collection, this link will get its parent collection

syncStartedstring

Represents the sync status of the collection. When it is null, there is no sync happening. When it has a DateTime value, that value represents the start time for the sync that is currently happening.

deletedstring

Date the collection was deleted

Example response

{
  "uri": "https://data.lucid.app/collections/3",
  "dataSource": "https://data.lucid.app/dataSources/1",
  "name": "Collection 1",
  "lastSync": "2021-01-01T00:00:00Z",
  "versionTimestamp": "2021-01-01T00:00:00Z",
  "created": "2021-01-01T00:00:00Z",
  "lastModified": "2021-01-01T00:00:00Z",
  "items": "https://data.lucid.app/collections/3/items",
  "schema": "https://data.lucid.app/collections/3/schema",
  "properties": "https://data.lucid.app/collections/3/properties",
  "metadata": "https://data.lucid.app/collections/3/metadata"
}

Changes

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