Skip to main content
POST
/
api
/
resources
Create Resource
curl --request POST \
  --url https://dash.empirical.run/api/resources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": 123,
  "name": "<string>",
  "mime_type": "<string>",
  "size_bytes": 123,
  "url": "<string>",
  "description": "<string>"
}
'
{
  "data": {
    "resource": {
      "id": 1,
      "project_id": 4,
      "name": "checkout-flow.docx",
      "upload_url": "https://...r2.cloudflarestorage.com/project-resources/...?X-Amz-...",
      "status": "pending",
      "description": null,
      "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "size_bytes": 245000,
      "created_by": "user-id",
      "created_at": "2026-03-20T10:30:00Z",
      "updated_at": "2026-03-20T10:30:00Z"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.empirical.run/llms.txt

Use this file to discover all available pages before exploring further.

Creates a resource record and returns a presigned upload URL. This is step 1 of the upload flow:
  1. Create — POST /api/resources → returns upload_url
  2. Upload — PUT the file to upload_url
  3. Confirm — PATCH /api/resources/{id} with {"status": "uploaded"}
Resources remain in pending status until confirmed. Only uploaded resources appear in list results. 
{
  "data": {
    "resource": {
      "id": 1,
      "project_id": 4,
      "name": "checkout-flow.docx",
      "upload_url": "https://...r2.cloudflarestorage.com/project-resources/...?X-Amz-...",
      "status": "pending",
      "description": null,
      "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "size_bytes": 245000,
      "created_by": "user-id",
      "created_at": "2026-03-20T10:30:00Z",
      "updated_at": "2026-03-20T10:30:00Z"
    }
  }
}

​
Full upload example

# Step 1: Create resource and get upload URL
curl -s -X POST \
  https://dash.empirical.run/api/resources \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY" \
  -d '{
    "project_id": 4,
    "name": "checkout-flow.docx",
    "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    "size_bytes": 245000
  }'

# Step 2: Upload file to the presigned URL (from response.data.resource.upload_url)
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  --data-binary @checkout-flow.docx

# Step 3: Confirm upload
curl -X PATCH \
  https://dash.empirical.run/api/resources/1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY" \
  -d '{"status": "uploaded"}'

Authorizations

​
Authorization
string
header
required

Project API key from the Empirical dashboard.

Body

application/json

Resource to create.

​
project_id
number
required

The project ID to associate the resource with.

​
name
string
required

Display name for the resource (typically the file name).

​
mime_type
string

MIME type of the file.

​
size_bytes
number

File size in bytes.

​
url
string

External URL (e.g. Google Sheet link). When provided, creates a link-type file with no R2 upload required.

​
description
string

Description for the resource.

Response

Created resource with presigned upload URL.

​
data
object
required