Skip to documentation
On this page
GearDex DocsPlatform API

Endpoints

The v1 API maps directly to the resources photographers and production teams manage inside GearDex.

Studio APIv1Updated August 2026
A straight desert road through the Coachella Valley at dawn
GearDex LogoGearDex
Live workspace

Request console

Inspect a GearDex resource

GET/gear

Query parameters

typecamera
qFujifilm
limit3
offset0
Response200 · 84 ms
{
 "data": [
 {
 "type": "camera",
 "brand": "Fujifilm",
 "model": "X-T5",
 "status": "available"
 }
 ], "total": 35
}

Endpoint index

GearDex Studio API endpoints
NameTypeDescription
GET /geargear:readList inventory with type, search, and pagination filters.
POST /geargear:writeCreate an owned gear record.
PATCH /gear/{id}gear:writeUpdate an owned gear record.
DELETE /gear/{id}gear:writeDelete gear and clean related records.
GET /shootsshoots:readList shoots with status, date, and search filters.
POST /shootsshoots:writeCreate a planning-state shoot.
PATCH /shoots/{id}shoots:writeUpdate production details, status, or progress.
DELETE /shoots/{id}shoots:writeDelete a shoot plan.
GET /maintenancemaintenance:readList service records and schedules.
POST /maintenancemaintenance:writeCreate service work for owned gear.
PATCH /maintenance/{id}maintenance:writeUpdate service status, cost, or provider.
DELETE /maintenance/{id}maintenance:writeDelete a maintenance record.
GET /documentsdocuments:readList document and warranty metadata.
GET /analyticsanalytics:readReturn aggregate Studio metrics.
GET /profileprofile:readReturn account and Studio profile metadata.

Gear

Query cameras, lenses, accessories, filters, and drones through one inventory resource. Write requests validate fields against the selected gear type and emit matching webhook events.

GET/geargear:read
POST/geargear:write
PATCH/gear/{id}gear:write
DELETE/gear/{id}gear:write

List Fujifilm gear (cURL)

curl -X GET "https://www.geardex.app/api/studio-agent/v1/gear?q=Fujifilm&limit=10" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Accept: application/json"

Create a camera (cURL)

curl -X POST "https://www.geardex.app/api/studio-agent/v1/gear" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "gear_type": "camera",
    "brand": "Fujifilm",
    "model": "X-T5",
    "condition": "excellent",
    "status": "available"
  }'

Update a camera (cURL)

curl -X PATCH "https://www.geardex.app/api/studio-agent/v1/gear/gear_item_uuid" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "gear_type": "camera",
    "updates": {
      "status": "maintenance",
      "notes": "Scheduled for sensor cleaning"
    }
  }'

Shoots

Build schedule views with status and date filters, or let a trusted planning service draft and maintain shoots.

GET/shootsshoots:read
POST/shootsshoots:write
PATCH/shoots/{id}shoots:write
DELETE/shoots/{id}shoots:write

Upcoming confirmed shoots (cURL)

curl -X GET "https://www.geardex.app/api/studio-agent/v1/shoots?status=confirmed&fromDate=2026-08-01&toDate=2026-08-31&limit=10" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Accept: application/json"

Create a shoot (cURL)

curl -X POST "https://www.geardex.app/api/studio-agent/v1/shoots" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Coastal Editorial",
    "client_name": "Northline Apparel",
    "shoot_date": "2026-08-18",
    "shoot_time": "06:30",
    "location": "Malibu, CA"
  }'

Maintenance

Service records stay connected to the exact owned item they affect. GearDex validates the gear reference before accepting a write.

GET/maintenancemaintenance:read
POST/maintenancemaintenance:write
PATCH/maintenance/{id}maintenance:write
DELETE/maintenance/{id}maintenance:write

Schedule service (cURL)

curl -X POST "https://www.geardex.app/api/studio-agent/v1/maintenance" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "item_type": "camera",
    "item_id": "gear_item_uuid",
    "service_type": "Sensor cleaning",
    "service_date": "2026-08-21",
    "service_provider": "Local camera shop",
    "status": "scheduled"
  }'

Read-only resources

GET/documentsdocuments:read
GET/analyticsanalytics:read
GET/profileprofile:read

Analytics summary (cURL)

curl -X GET "https://www.geardex.app/api/studio-agent/v1/analytics" \
  -H "Authorization: Bearer gdx_live_your_key_here" \
  -H "Accept: application/json"

Pagination

Collection endpoints use limit and offset. Responses include returned and total counts so clients can advance through results without guessing.

Pagination shape

{
  "pagination": {
    "limit": 25,
    "offset": 0,
    "returned": 25,
    "total": 83
  }
}