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

GearDexStudio consoleRequest console
Inspect a GearDex resource
/gearQuery parameters
typecameraqFujifilmlimit3offset0{
"data": [
{
"type": "camera",
"brand": "Fujifilm",
"model": "X-T5",
"status": "available"
}
], "total": 35
}Endpoint index
| Name | Type | Description |
|---|---|---|
GET /gear | gear:read | List inventory with type, search, and pagination filters. |
POST /gear | gear:write | Create an owned gear record. |
PATCH /gear/{id} | gear:write | Update an owned gear record. |
DELETE /gear/{id} | gear:write | Delete gear and clean related records. |
GET /shoots | shoots:read | List shoots with status, date, and search filters. |
POST /shoots | shoots:write | Create a planning-state shoot. |
PATCH /shoots/{id} | shoots:write | Update production details, status, or progress. |
DELETE /shoots/{id} | shoots:write | Delete a shoot plan. |
GET /maintenance | maintenance:read | List service records and schedules. |
POST /maintenance | maintenance:write | Create service work for owned gear. |
PATCH /maintenance/{id} | maintenance:write | Update service status, cost, or provider. |
DELETE /maintenance/{id} | maintenance:write | Delete a maintenance record. |
GET /documents | documents:read | List document and warranty metadata. |
GET /analytics | analytics:read | Return aggregate Studio metrics. |
GET /profile | profile:read | Return 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.
/geargear:read/geargear:write/gear/{id}gear:write/gear/{id}gear:writeList 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.
/shootsshoots:read/shootsshoots:write/shoots/{id}shoots:write/shoots/{id}shoots:writeUpcoming 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.
/maintenancemaintenance:read/maintenancemaintenance:write/maintenance/{id}maintenance:write/maintenance/{id}maintenance:writeSchedule 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
/documentsdocuments:read/analyticsanalytics:read/profileprofile:readAnalytics 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
}
}