Muzeek SDK

The TypeScript toolkit designed to help developers build AI-powered music industry applications with Next.js, React, Node.js, and more.

The Muzeek SDK abstracts away the differences between music industry workflows, eliminates boilerplate code for building music management systems, and allows you to go beyond basic CRUD operations to create rich, interactive experiences for artists, venues, and booking agents.

Generating text

At the center of the Muzeek SDK is Muzeek API Core, which provides a unified API to call any music industry workflow.

The following example shows how to manage events with the Muzeek SDK using our Events API:

Managing Events
TypeScript
Create, update, and manage events with the Muzeek Events API
import { eventsApi } from '@muzeek/sdk';
const events = await eventsApi.getEvents({
include: 'venue.full,tour,account',
sortBy: 'startDate',
limit: 10
});

The unified interface means that you can easily switch between different data sources by changing just a few lines of code. For example, to fetch a specific event with full venue details:

const event = await eventsApi.getEvent((
'event-uuid-here',
accountUniqueId,
organizationId,
{ include: 'venue.full,tour.full,account' }
)

Generating structured data

While event management can be useful, you might want to integrate with other parts of the music industry ecosystem. For example, you might want to manage venues, track tours, or handle artist bookings. Muzeek API Core provides comprehensive endpoints for all aspects of music industry management.

GET /api/events
GET
Retrieve a list of events with pagination, filtering, and includes

Query Parameters

pagePage number (default: 1)
limitItems per page (max: 100)
includevenue, tour, account
sortBystartDate, title, createdAt
POST /api/events
POST
Create a new event with venue and tour associations

Request Body

{
"title": "Concert Name",
"eventType": "show",
"startDate": "2024-03-15T20:00:00Z",
"venueId": "venue-uuid",
"tourId": "tour-uuid"
}

Events API

The Events API allows you to manage all aspects of live music events, from creation to completion. Events are the core of the music industry workflow.

GET /api/events/[id]
GET
Retrieve a specific event with full details and relationships

Path Parameters

idEvent UUID

Include Options

venue.full - Full venue details
tour.full - Full tour details
account - Account information
PUT /api/events/[id]
PUT
Update an existing event with partial data

Example Update

{
"title": "Updated Concert Name",
"startDate": "2024-03-16T20:00:00Z"
}

Authentication

The Muzeek API supports two authentication methods to fit different use cases.

Session Authentication
Recommended
For web applications with user sessions

Use session-based authentication for interactive web applications where users sign in through your interface.

// Automatically handled by Clerk
const events = await eventsApi.getEvents();
API Key Authentication
For server-to-server integrations

Use API keys for backend services, webhooks, and automated systems.

headers: {
'Authorization': 'Bearer your-api-key'
}