POST
/
document
curl --request POST \
  --url https://{api-address}.org.machina.gg/document \
  --header 'Content-Type: application/json' \
  --header 'x-api-token: <api-key>' \
  --data '{
  "embed-vector": false,
  "metadata": {
    "agent_id": "123"
  },
  "name": "New test document",
  "value": {
    "chat": [
      "What is Lorem Ipsum?",
      "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry'\''s standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
      " It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum."
    ]
  }
}'
{
  "data": {
    "_id": "67e1fc8c2a5ade8c69c03fe7",
    "created": "Tue, 25 Mar 2025 00:45:00 GMT",
    "embed-vector": false,
    "id": "67e1fc8c2a5ade8c69c03fe7",
    "metadata": {
      "agent_id": "123"
    },
    "name": "New test document",
    "status": null,
    "updated": "Tue, 25 Mar 2025 00:45:00 GMT",
    "value": {
      "chat": [
        "What is Lorem Ipsum?",
        "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
        " It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum."
      ]
    }
  },
  "message": "document saved",
  "status": true
}

Authorizations

​
x-api-token
string
header
required

API key authentication

Body

application/json
​
name
string
required

Unique identifier for the document

​
value
object

The main data of the document, can be any type (string, object, array, etc.)

​
metadata
object

Additional metadata for the document

​
status
enum<string>
default:active

Current status of the document

Available options:
active,
draft,
archived
​
embed-vector
boolean

Whether to create a vector embedding for the document

Response

200
application/json
Document created successfully
​
data
object
​
message
string

Success message

​
status
boolean

Operation status