Jams Enpoint (Draft WIP) - lolmaxz/vrc-ts GitHub Wiki

Jams API Documentation

The Jams API allows you to interact with VRChat Jams—events or competitions where users can submit content like worlds or avatars.


Index

  1. getJamsList - Retrieve a list of Jams, optionally filtered by active status and type.

  2. getJamInfo - Get detailed information about a specific Jam.

  3. getJamSubmissions - Retrieve a list of submissions for a specific Jam.


Endpoints

1. getJamsList

Purpose

Retrieve a list of Jams, optionally filtered by active status and type.

Method Signature

getJamsList(options: { isActive?: boolean; type?: 'world' | 'avatar' }): Promise<Jam[]>

Parameters

  • options (object, optional):
    • isActive (optional): boolean
      Filter Jams by active status.
      • true: Returns only active Jams.
      • false: Returns only inactive Jams.
    • type (optional): 'world' or 'avatar'
      Filter Jams by type.

Returns

  • Promise<Jam[]>: A promise that resolves to an array of Jam objects.

Example Usage

// Example: Get all active world Jams
const activeWorldJams = await vrchatApi.jamApi.getJamsList({ isActive: true, type: 'world' });
console.log(activeWorldJams);

// Example: Get all Jams regardless of status or type
const allJams = await vrchatApi.jamApi.getJamsList({});
console.log(allJams);

2. getJamInfo

Purpose

Get detailed information about a specific Jam.

Method Signature

getJamInfo(jamId: string): Promise<Jam>

Parameters

  • jamId (string): The unique identifier of the Jam.

Returns

  • Promise<Jam>: A promise that resolves to a Jam object containing detailed information.

Example Usage

// Example: Get information about a specific Jam
const jamId = 'your-jam-id';
const jamInfo = await vrchatApi.jamApi.getJamInfo(jamId);
console.log(jamInfo);

3. getJamSubmissions

Purpose

Retrieve a list of submissions for a specific Jam.

Method Signature

getJamSubmissions(jamId: string): Promise<JamSubmission[]>

Parameters

  • jamId (string): The unique identifier of the Jam.

Returns

  • Promise<JamSubmission[]>: A promise that resolves to an array of JamSubmission objects.

Example Usage

// Example: Get submissions for a specific Jam
const jamId = 'your-jam-id';
const submissions = await vrchatApi.jamApi.getJamSubmissions(jamId);
console.log(submissions);

Note: Replace 'your-jam-id' with the actual Jam ID you want to query.


These endpoints allow you to list Jams, get detailed information about a specific Jam, and retrieve submissions for a Jam. They require authentication and are useful for interacting with VRChat's community events programmatically.

⚠️ **GitHub.com Fallback** ⚠️