Lucid

Lucid Collection API

Create, retrieve, update, and delete collections within a data source. A collection is a named group of data items that share a common schema (similar to a database table).

GitHub OpenAPI

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

HEAD /collections Count the collections I can access · Get Total Collections Count #
Ask an LLM
“How many data collections do I have access to?”
“Is there a quick way to get a total collection count without fetching them all?”
Tell an agent
Count my collections.
Tell me the total number of collections I can access.
GET /collections List all data collections I can access · Get All Collections #
Ask an LLM
“Which data collections do I have access to in Lucid?”
“Can I page through my collections using a start and end range?”
Tell an agent
List all my data collections.
Get collections from {start} to {end}.
POST /collections Create a data collection in a data source · Create Collection #
Ask an LLM
“How do I add a new collection with a schema to an existing data source?”
“What do I need to supply to create a collection?”
Tell an agent
Create collection {name} in data source {dataSource} with schema {schema} and properties {properties}.
Add a {name} collection to data source {dataSource} using schema {schema}, properties {properties}.
GET /collections/{collectionId} Get one data collection · Get Collection #
Ask an LLM
“What does a specific collection look like in Lucid?”
“Can I fetch a single collection by its ID?”
Tell an agent
Get collection {collectionId}.
Show me the details of collection {collectionId}.
PATCH /collections/{collectionId} Rename a collection or move its data source · Update Collection #
Ask an LLM
“Can I rename a collection after it's been created?”
“Is it possible to point a collection at a different data source?”
Tell an agent
Rename collection {collectionId} to {name}.
Move collection {collectionId} to data source {dataSource}.
DELETE /collections/{collectionId} Delete a collection and its items · Delete Collection #
Ask an LLM
“Does deleting a collection also remove its schema, items and metadata collections?”
“Will the data source survive if I delete one of its collections?”
Tell an agent destructive · confirm first
Delete collection {collectionId}.
Permanently remove collection {collectionId} and everything in it.
GET /collections/{collectionId}/metadata List metadata collections of a collection · Get All Metadata Collections #
Ask an LLM
“Which metadata collections are attached to a given collection?”
“How can I find the metadata collections that hang off a parent collection?”
Tell an agent
List metadata collections on collection {collectionId}.
Show the metadata attached to collection {collectionId}.
POST /collections/{collectionId}/metadata Add a metadata collection to a collection · Create Metadata Collection #
Ask an LLM
“How do I attach a metadata collection to an existing collection?”
“Can metadata collections be edited later once created?”
Tell an agent
Create metadata collection {name} of type {metadataType} on collection {collectionId} with schema {schema} and properties {properties}.
Attach {metadataType} metadata named {name} to collection {collectionId}, schema {schema}, properties {properties}.

Documentation

📖
Documentation
https://developer.lucid.co/docs/welcome
📖
APIReference
https://developer.lucid.co/reference/api
📖
APIReference
https://developer.lucid.co/reference/overview-scim

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lucid/refs/heads/main/openapi/lucid-collection-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/lucid:lucid-collection-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lucid-collection-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Lucid Data Collection API
  version: '1.0'
  description: The Lucid Data API enables external applications to create, read, update, and delete structured data linked to Lucid documents. Use it to sync data sets, collections, and schemas between your data sources and Lucid diagrams. Authenticate via OAuth 2.0.
  contact:
    name: Lucid Developer Platform
    url: https://developer.lucid.co/
  x-documentation: https://developer.lucid.co/reference/data-api
servers:
- url: https://data.lucid.app
tags:


# --- truncated at 32 KB (43 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lucid/refs/heads/main/openapi/lucid-collection-api-openapi.yml