Getting started

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

StudioThe Studio API, webhooks, and MCP adapter are included with the Studio plan.Compare plans

Download Markdown

Prerequisites

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

Create an API key

Sign in and open Settings, then API & Agents.
Click Create API key.
Pick only required scopes. Available: gear:read, gear:write, shoots:read, shoots:write, maintenance:read, maintenance:write, documents:read, analytics:read, profile:read, loans:read, loans:write, bookings:read, bookings:write, money:read, money:write.
Set an expiration window and save the key securely.

First request

Send the key as a bearer token. This returns your three most recent gear records. See Authentication for a JavaScript version.

bashRequest (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.env example

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

Rotation and 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.