Skip to main content
Your Team, OrganizedStart Free Trial
Developer Resources

GalaDesk API Documentation

Build powerful integrations with the GalaDesk platform. RESTful API with comprehensive documentation and SDKs.

Get StartedAPI Reference

Quick Start Guide

Get up and running with the GalaDesk API in minutes

1

Get API Keys

Sign up for a GalaDesk account and generate your API keys from the dashboard.

2

Make Your First Request

Use your API keys to authenticate and make your first API call.

3

Build Your Integration

Explore endpoints, webhooks, and build your custom integration.

API Capabilities

RESTful Architecture

Clean, predictable endpoints following REST best practices with JSON responses.

Secure Authentication

OAuth 2.0 and API key authentication with role-based access control.

Real-time Webhooks

Subscribe to events and receive instant notifications for job updates, assignments, and more.

Comprehensive SDKs

Official SDKs for JavaScript, Python, and Ruby with full TypeScript support.

API Reference

GET
/api/v1/jobs

List all jobs for your organization

Parameters:

page
integer
Page number for pagination
limit
integer
Number of results per page (max 100)
status
string
Filter by job status (pending, assigned, completed)
POST
/api/v1/jobs

Create a new job

Parameters:

title
string
Job title (required)
venue_id
string
Venue ID from venue database
date
date
Job date in ISO 8601 format
time_start
time
Start time in HH:MM format
time_end
time
End time in HH:MM format
GET
/api/v1/team

List all team members in your organization

Parameters:

role
string
Filter by role (admin, manager, employee)
status
string
Filter by status (active, inactive)
POST
/api/v1/assignments

Assign an employee to a job

Parameters:

job_id
string
Job ID (required)
employee_id
string
Employee user ID (required)
role
string
Role for this assignment (e.g., lead photographer)

This is a preview of our API documentation. Full documentation coming soon.

Request API Access

Getting Started

Authentication

All API requests require authentication using API keys. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Example Request

Here’s a simple example to get all jobs:

curl -X GET "https://api.galadesk.com/v1/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Rate Limits

API requests are rate limited to 1000 requests per hour per organization. Rate limit information is included in response headers.

Official SDKs

Coming soon - Official libraries for your favorite languages

JavaScript / TypeScript

Coming Soon

Full TypeScript support with type definitions

Python

Coming Soon

Pythonic API with async support

Ruby

Coming Soon

Idiomatic Ruby gem with Rails integration

Developer Resources

Additional resources to help you integrate with GalaDesk

API Changelog

Stay updated with the latest API changes and improvements

Status Page

Monitor API uptime and service status

Community Forum

Connect with other developers and share integrations

Support

Get help from our developer support team

Ready to Build with GalaDesk?

Start integrating today and unlock the full power of the GalaDesk platform.

Get API Access