Super custom sources

If your source is in high demand and you need it as a paid Super customer, we'll prioritise it,  reach out !

You can build your own source if you want to index specific data to your Super workspace. The custom sources do not support specific permissions, everyone in your Super workspace will be able to ask on indexed objects.


Step by step

1. Create a new source

Head to the Data source panel, in the Custom section. You can create a new custom source from there and get the customSourceId to use.


2. Get your API key

You'll need an API key to authenticate with the public API.
    Head to your Settings
    Hit the API tab
    Click on "Create a new key" and follow the instructions


3. Index your data through the public API

You can then call the /ask/index endpoint, pushing 1 object at a time in markdown or HTML. You can use the id of the service of origin as a reference to update an existing object, and the updatedAt key to indicate Super how fresh the information is.

curl --request POST \
  --url https://api.super.work/v1/super/index \
  --header 'Authorization: Bearer <API Key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rootId": [
    "a2ZSuHnZf"
  ],
  "id": [
    "custom-id"
  ],
  "title": [
    "Note title"
  ],
  "content": [
    "# Content in markdown"
  ],
  "type": [
    "markdown"
  ],
  "updatedAt": [
    "2021-01-01T00:00:00Z"
  ],
  "url": [
    "https://slite.slite.page/p/S1TSuHnZf/Security-at-Slite"
  ]
}'


4. See your data indexed in the sources panel

You can now head back to your source and see the count of objects indexed for a given custom source.


Use Zapier to send your data

For easy setup, you can also use our  Zapier integration  to index objects from their UI.