📄 Data Entities
Add a Data Entity
📄 Data Entities
Add a Data Entity
This endpoint creates a new Data Entity.
POST
/
v1
/
data-entities
Two-step process
This endpoint is a two-step process. First, you create the data entity’s URL, and then you upload the file to the signed URL.
- Step 1:
POST https://api.getmetal.io/v1/data-entities - Step 2:
PUTto the signed URL
Step 1: Request URL for the File
Auth Headers
x-metal-api-key
string
requiredAn API key for your org.
x-metal-client-id
string
requiredA Client ID for your org.
Body
datasource
ObjectID
requiredThe datasource ID.
name
string
requiredThe name of the data entity.
metadata
object
An object of metdatadata keys/values. The key is the field key and the value is the field value for this entity.
sourceType
string
requiredThe type of the source (e.g., “PDF”, “Text”).
Response
data
Data Entity Object
Step 2: Upload the File to the Signed URL
# Example Request
curl --location --request PUT '<preSignedUrl>' \
--header 'Content-Type: application/pdf' \
--upload-file '/path/to/your/example.pdf'