Api exploration

Skill fusebase-dev/fusebase-flow/.agents/skills/api-exploration

Workflow for testing Fusebase API calls interactively using temporary tokens. Use when: 1. You need to verify an API endpoint behavior before writing app code, 2. You want to explore available API responses or schemas, 3. You're unsure how an API endpoint works and need to test it, 4. Debugging API integration issues by making direct calls.From its SKILL.md

Install

npx -y skills add fusebase-dev/fusebase-flow --skill api-exploration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.0 KB, as published. Nobody here has run it

API Exploration with Temporary Tokens

When you're unsure about an API endpoint's behavior, response shape, or want to test a flow before committing to implementation — create a temporary token and run test calls directly.

Workflow

1. Create a temporary token

fusebase token create --app <appId>

This outputs a short-lived token (15 min) to stdout. Capture it:

TOKEN=$(fusebase token create --app <appId>)

The appId comes from fusebase.json → apps[].id.

2. Write and run test code

Create a temporary script (e.g. _test-api.ts) to make the API calls you want to verify:

const token = process.env.TOKEN || "<paste-token-here>";

const res = await fetch("https://api-endpoint/...", {
  headers: { "x-app-feature-token": token },
});
console.log(res.status);
console.log(await res.json());

Run it:

TOKEN=$(fusebase token create --app <appId>) bun _test-api.ts

3. Inspect results and iterate

Read the output, adjust your calls, and re-run. Once you understand the API behavior, implement it properly in your app code.

4. Clean up

Delete the temporary test script when done — don't commit it.

Example: Testing `@fusebase/dashboard-service-sdk`

Use this to verify SDK calls before wiring them into app UI code.

_test-sdk.ts:

import {
  createClient,
  DatabasesApi,
  CustomDashboardRowsApi,
} from "@fusebase/dashboard-service-sdk";

const token = process.env.TOKEN!;
const BASE_URL =
  "https://app-api.{FUSEBASE_HOST}/v4/api/proxy/dashboard-service/v1";

const client = createClient({
  baseUrl: BASE_URL,
  defaultHeaders: { "x-app-feature-token": token },
});

const dbApi = new DatabasesApi(client);
const rowsApi = new CustomDashboardRowsApi(client);

// List databases visible to this app
const dbs = await dbApi.listDatabases({});
console.log("databases:", JSON.stringify(dbs, null, 2));

// Read rows from a specific dashboard view
const rows = await rowsApi.getRows({
  dashboardId: "<dashboardId>",
  viewId: "<viewId>",
});
console.log("rows:", JSON.stringify(rows, null, 2));