Collection

Get All Metadata Collections

This endpoint returns a list of Collections for any metadata collections that exist on the requested collection. The return will only occur if the user has access to the data source. Each metadata collection will have a link to its parent collection in the parent field.

get/collections/{collectionId}/metadata

Request

  • Base URL
    https://data.lucid.app
  • URL
    https://data.lucid.app/collections/{collectionId}/metadata
  • 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 return metadata collections for

Response

OK with Array[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.