Skip to main content

shortcut_api

Custom badge

A Shortcut (formerly clubhouse) api wrapper for deno.

Usage

Import the Shortcut client and initialize it with your token.

import { Shortcut } from "https://deno.land/x/shortcut_api@v1.0.1/mod.ts";

const client = new Shortcut({ token: "xxx-xxx-xxx" });

Via env

Define env var SHORTCUT_API_TOKEN with your token.

⚠️ With this method you will have to launch your application with the --allow-env flag

const client = new Shortcut();

Features

From the client all the methods currently accessible (14/09/2021) from the API v3 are available. https://shortcut.com/api/rest/v3

Categories, Entity-Templates, Epic-Workflow, Epics, External-Link, Files, Groups, Iterations, Labels, Linked-Files, Member, Members, Milestones, Projects, Repositories, Search, Stories, Story-Links, Workflows

Examples

// Get all projects
const projects = await client.getProjects();

// Add a new story for the first project
const story = await client.createStory({
  name: "Fake story",
  project_id: projects[0].id,
  description: "Fake description",
});

const updatedStory = await client.updateStory(story.id, {
  description: "Updated fake description",
});

await client.deleteStory(/* ... */);

// Get iterations
const iterations = await client.getIterations();