Media

List, get, upload, and delete media items in your workspace.

List media

GET /api/v1/media

Returns a paginated list of all media in your workspace.

Query parameters

Param	Type	Default	Description
page	int	1	Page number
per_page	int	20	Items per page (max 100)
creator_id	string	—	Filter by creator ID
category_id	string	—	Filter by category ID
status	string	—	Filter: pending, indexing, complete, error
type	string	—	Filter: video, image

Example

curl -H "Authorization: Bearer findclix_..." \
  "https://findclix.com/api/v1/media?page=1&per_page=5"

Response

{
  "success": true,
  "data": [
    {
      "id": "53aebcdc-...",
      "filename": "simple walk.MP4",
      "url": "https://assets.findclix.com/...",
      "thumbnail": "https://assets.findclix.com/thumb__....jpg",
      "type": "video",
      "status": "complete",
      "size": 2734894,
      "duration": 7,
      "width": 480,
      "height": 854,
      "category_ids": [],
      "creators": [],
      "notes": "Indexing complete",
      "created_at": "2026-07-07T15:09:50.978Z"
    }
  ],
  "meta": {
    "total": 9,
    "page": 1,
    "per_page": 5,
    "total_pages": 2,
    "has_more": true
  }
}

Interactive reference

List media items

GET

/media

Playground

Authorization

ApiKeyAuth

Variables

Key

Value

page

per_page

creator_id

category_id

status

type

Samples

---

Get media

GET /api/v1/media/:id

Returns a single media item by ID.

Example

curl -H "Authorization: Bearer findclix_..." \
  "https://findclix.com/api/v1/media/53aebcdc-beb1-4968-bd84-9c7d4a80334f"

Response

{
  "success": true,
  "data": {
    "id": "53aebcdc-...",
    "filename": "simple walk.MP4",
    "url": "https://assets.findclix.com/...",
    "type": "video",
    "status": "complete",
    "size": 2734894,
    "duration": 7,
    "created_at": "2026-07-07T15:09:50.978Z"
  }
}

Interactive reference

Get media item

GET

/media/{id}

Playground

Authorization

ApiKeyAuth

Variables

Key

Value

id*

Samples

---

Upload media

POST /api/v1/media/upload
Content-Type: multipart/form-data

Upload a video or image file. The file is stored in R2 and automatically indexed for search.

Form fields

Field	Type	Required	Description
file	File	Yes	Video or image file
creator_ids	string	No	Comma-separated creator IDs to associate
category_ids	string	No	Comma-separated category IDs to associate

Example

curl -X POST -H "Authorization: Bearer findclix_..." \
  -F "file=@video.mp4" \
  -F "creator_ids=abc-123,def-456" \
  "https://findclix.com/api/v1/media/upload"

Response

{
  "success": true,
  "data": {
    "id": "987a0257-...",
    "url": "https://assets.findclix.com/..."
  }
}

INFO

After upload, the file is indexed asynchronously. The status field will transition from pending → indexing → complete. Poll the media item or use the search API to check readiness.

Interactive reference

Upload and index media

POST

/media/upload

Playground

Authorization

ApiKeyAuth

Body

file*

creator_ids

category_ids

Samples

---

Delete media

DELETE /api/v1/media/:id

Permanently deletes a media item and its associated chunks from the database and R2 storage.

Example

curl -X DELETE -H "Authorization: Bearer findclix_..." \
  "https://findclix.com/api/v1/media/53aebcdc-..."

Response

{
  "success": true,
  "data": {
    "id": "53aebcdc-...",
    "deleted": true
  }
}

WARNING

This action is irreversible. The media file, its thumbnails, and all vector embeddings are permanently removed.

Interactive reference

Delete media item

DELETE

/media/{id}

Playground

Authorization

ApiKeyAuth

Variables

Key

Value

id*

Samples