Python SDK for Data Connector Actions (Collection API)

Hi Dan,

Is there a Python SDK / REST API for writing to Collections?

There is no Python SDK today. But the HTTP endpoint that client.update() calls is public so you can call it directly with the following:

  - Method/URL: POST https://api.lucid.co/v1/data/dataSource/update (also served at /data/dataSource/update)


  - Headers:
    - Content-Type: application/json
    - Lucid-Api-Version: 1 
    - data-update-token: <token>


  - Body (camelCase): 
  {
    "name": "<dataSourceName>",
    "upstreamConfig": { ... },
    "sourceForeignKeys": [ ... ],
    "creationPermission": "<...>",
    "updateData": {
      "<collectionId>": { 
        "schema": {
          "fields": [ ... ],
          "primaryKey": [ ... ],
          "fieldLabelOverrides": { ... }
        },
        "itemsPatch": {
          "items": {
            "<primaryKey>": { 
              ...serializedFields 
            } 
          },
          "itemsDeleted": [ ... ]
        },
        "properties": {
          "Represents": [ ... ],
          "Name": "...",
          "IsHiddenFromDataPanel": false
        }
      }
    }
  }

The field shapes should match what you're already constructing in TypeScript (SerializedFields, SchemaDefinition, etc.).

You can get the token from action requests Lucid sends to your data connector. The inbound POST body looks like:

  {
    "action": { "name": "MyAction", "data": ... },
    "packageId": "...",
    "userCredential": "...",
    "documentUpdateToken": "<-- THIS IS THE TOKEN>",
    "documentCollections": { ... },
    "userId": 123,
    "accountId": 456,
    "documentId": "..."
  }

In your Python handler, you can read the body["documentUpdateToken"] and forward it as the data-update-token header on the outbound POST /v1/data/dataSource/update.

The field is nullable — it's only present for actions targeting a document, not for things like webhook setup, so it may be empty on some requests.

Let me know if this helps or you still have questions.
Thanks,
Kyler