Insert a record

Free

Adds a record (any JSON object) to a named collection, creating the collection if it does not exist. Optionally indexes a text field or string for semantic search so the record can be found later by meaning.

Cost

Free

What it accepts

Set these inside the intent when you run it.

collectionrequired

Name of the collection to insert into.

recordrequired

The JSON object to insert as a record.

embed_textoptional

Text to index for semantic search on this record.

embed_fieldoptional

Field name within the record whose value should be indexed for semantic search.

What you get back

The inserted record with its assigned id and metadata.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Tables skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/tables/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"insert","collection":"products","record":"{\"name\": \"Widget\", \"price\": 9.99}","embed_text":"A lightweight widget for everyday use","embed_field":"description"}}'

Example requests

›Add this item to my products collection
›Store this user record in the contacts collection
›Insert this note and index its content for search

← Back to Tables