using-fianu-api

Query any Fianu platform endpoint using the fianu api CLI and a grep-able route index.

1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/fianulabs/fianu-skills --skill using-fianu-api-fianulabs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-fianu-api
Source: https://github.com/fianulabs/fianu-skills/tree/main/skills/using-fianu-api
Command: npx skills add https://github.com/fianulabs/fianu-skills --skill using-fianu-api-fianulabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Investigating the Fianu compliance platform often requires endpoints that no dedicated skill documents — the proxy exposes roughly 900 routes, and guessing URLs or hand-rolling curl calls wastes time and produces errors. This Skill provides the canonical way to reach any route from a shell and to look up its method, path, and auth requirements. ## Core Features & Use Cases - Authenticated API passthrough: The fianu api CLI handles token exchange, /api prefixing, JSON encoding, pagination (--paginate), response filtering (--jq), and non-zero exit codes on errors. - Grep-able route index: references/api-index.md lists all ~900 externally reachable routes with METHOD, PATH, DEST, SERVICE, and AUTH columns, including the PATH-vs-DEST distinction that explains why documented paths sometimes 404. - Write safety guidance: Documents how -f/-F/--input flip the default method to POST, typed field handling, and the rule that the token's subject is always the actor on writes. - Use Case: You need to find why a gate evaluation failed but no skill covers gate routes. Grep the index for gates, check the AUTH column, then call the narrowest GET with --jq to project only the fields you need. ## Quick Start Ask the agent to look up the Fianu API route for a resource like exceptions or attestations and call it with fianu api using pagination and a jq filter.

Frequently Asked Questions about using-fianu-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I call a Fianu API endpoint from the command line?▼

Use `fianu api <path>` without the `/api` prefix; it handles authentication, JSON encoding, and exit codes. Add `-f` or `-F` for fields, `--input` for a raw body, `--paginate` to follow Link headers, and `--jq` to filter the response.

How do I find which Fianu endpoint to call for a resource?▼

Grep `references/api-index.md` for the resource noun, such as `grep -i ticket references/api-index.md`. The index lists METHOD, PATH, DEST, SERVICE, and AUTH for all ~900 routes; never read the whole file since it is about 140KB.

Why does a documented Fianu endpoint return 404?▼

The path is probably a DEST (internal service route) rather than the external PATH. Grep the index for it and use the PATH column on the same row, which is the callable form through the proxy.

Why does fianu api send a POST when I expected a GET?▼

Supplying any of `-f`, `-F`, or `--input` flips the default method from GET to POST. For any other verb, set it explicitly with `-X`, for example `fianu api some/endpoint -X PUT -F enabled=true`.

What is the difference between a 403 and a 404 on the Fianu proxy?▼

A 403 means the route exists but your token lacks the feature or role named in the index's AUTH column, so retrying other paths will not help. A 404 means the path itself is wrong, often a DEST instead of a PATH.

When should I use raw curl instead of fianu api?▼

Only when the fianu CLI is not installed in the environment. Raw HTTP requires reproducing token exchange, the `/api` prefix, and pagination manually; the wire-level contract for that fallback is documented in the using-fianu-skills references.