Skip to documentation
GearDexGearDex
On this page
GearDex DocsGuide

Getting Started

Set up your first Studio API integration in minutes with secure key management defaults.

Studio APIv1Updated August 2026
A sunrise trail between Joshua trees and granite boulders
GearDex LogoGearDex
Live workspace

Quickstart

Your first request

Setup progress

Create a scoped key

Complete

Store the secret

Complete

3

Send your first request

Ready

GET/gear?limit=3200 OK
curl "https://www.geardex.app/
api/studio-agent/v1/gear?limit=3"
 -H "Authorization: Bearer gdx_live_••••"

{
 "data": [
 { "brand": "Fujifilm",
 "model": "X-T5" }
 ],
 "total": 35
}

Prerequisites

  • Studio subscription with API access enabled
  • An external agent runtime (Claude Desktop, Cursor, custom app, etc.)
  • Secure environment variable storage for credentials

Create API Key

  1. Open Settings → API & Agents.
  2. Click Create API key.
  3. Pick only required scopes (available: gear:read, gear:write, shoots:read, shoots:write, maintenance:read, maintenance:write, documents:read, analytics:read, profile:read).
  4. Set an expiration window and save the key securely.

First Request

Request (cURL)

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

Secure Storage

.env Example

GEARDEX_BASE_URL=https://www.geardex.app
GEARDEX_STUDIO_API_KEY=gdx_live_your_key_here

Rotation & Revocation

Rotate keys proactively and revoke immediately if an integration is no longer needed or you suspect exposure.

  • Use one key per integration.
  • Prefer expiring keys over permanent keys.
  • Review API activity logs in Settings regularly.