---
title: "Infisical API Skill: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/infisical-api/
description: "Infisical skill for calling the Infisical REST API directly: Universal Auth login, /api/v4/secrets CRUD and batch calls, projects and identities, pagination and rate limits."
---

# Infisical API Skill: review, setup & limitations · Undominated.ai

> Infisical skill for calling the Infisical REST API directly: Universal Auth login, /api/v4/secrets CRUD and batch calls, projects and identities, pagination and rate limits.

[← Explore all skills](/skills/)

SECURITY / Infisical Inc.

# Infisical API Skill

Infisical skill for calling the Infisical REST API directly: Universal Auth login, /api/v4/secrets CRUD and batch calls, projects and identities, pagination and rate limits.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 6 linked sources
 Publisher Infisical Inc.
 Licence [MIT ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE)
 Revision d7e7fa443893
 [Read what was—and wasn’t—checked ↓](#review)

“Interact with the Infisical REST API to manage secrets, projects, environments, machine identities, and more. Supports secret CRUD operations, machine identity authentication, pagination, and rate limiting on cloud deployments. Not for the CLI/SDKs (infisical-setup), KMS crypto endpoints (infisical-kms), certificate endpoints (infisical-pki), or human SSO login (infisical-sso).”

 [Infisical Inc. · upstream description ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It states that /api/v4/secrets is not paginated and ignores offset and limit, while identities, memberships and certificates paginate and return { <resource>: [...], totalCount: n }.
- It gives the instance default rate limits, which apply to self-hosted too (60 reads/min, 200 writes/min, 60 secrets-ops/min, 60 auth/min per IP), and says to honour retry-after as seconds remaining.

### A good fit for

 - Get a Bearer token from the Universal Auth login endpoint before other calls
- List every secret at a path, including subfolders with recursive=true
- Replace per-secret loops with POST, PATCH or DELETE on /api/v4/secrets/batch
- Move code off the deprecated v1/v2/v3 secret endpoints and /api/v1/workspace

### Weigh up before choosing

 - It covers the core secrets, projects and identities API; KMS, certificate, sync, rotation and App Connection endpoints are left to their own skills.
- Its curl examples use us.infisical.com; EU users need eu.infisical.com and self-hosted users their own domain.
- Cloud rate limits vary by plan, so the stated limits are instance defaults, not a cloud guarantee.
- skills/infisical-api was last changed on 2026-08-12 (commit da9176b6) as of the reviewed pin d7e7fa44.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/infisical-api/SKILL.md
- README.md
- LICENSE
- .claude-plugin/marketplace.json

### Our findings

 - The quick start posts clientId and clientSecret to /api/v1/auth/universal-auth/login and sends the returned accessToken as a Bearer token.
- It says service tokens are deprecated in favour of machine identities.
- It says viewSecretValue defaults to true and can be set to false when only key names are needed.

### Not established by this review

 - Not executed: it was not installed or run.
- No Infisical API request was sent.
- references/authentication.md, references/secrets-endpoints.md, references/projects-and-identities.md and references/pagination-and-rate-limits.md were not read.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md)
 - The README's universal install, npx skills add Infisical/ai-skills, names the whole Infisical/ai-skills repository, which the README says holds 17 skills; no file at the pin prints a line that installs infisical-api alone.
- For Claude Code the README prints /plugin marketplace add Infisical/ai-skills. That adds the infisical-ai-skills marketplace, whose .claude-plugin/marketplace.json lists infisical-api as its own plugin (source ./infisical-api, plugin root ./plugins); no file at the pin prints the line that installs that plugin.
- For a manual install the README says to copy skill folders from skills/ into the agent's skills directory; for this skill that is skills/infisical-api/, copied to .claude/skills/ (Claude Code), ~/.codex/skills/ (Codex), .cursor/skills/ or .agents/skills/ (Cursor), or .github/skills/ (GitHub Copilot).
- The README recommends Infisical's hosted docs MCP at https://infisical.com/docs/mcp ahead of the skills; that is a separate server and does not install infisical-api.

### Before you start

 - A machine identity with Universal Auth, whose client ID and client secret the login call takes

### Compatibility

skills CLI · Claude Code · Codex · Cursor · GitHub Copilot

### Guidance for direct REST calls that create, change and delete secrets; no tools declared

 - Loads SKILL.md and, when needed, references/authentication.md, references/secrets-endpoints.md, references/projects-and-identities.md or references/pagination-and-rate-limits.md; the frontmatter declares no allowed-tools and the directory holds Markdown only.
- Its examples send a machine identity's client ID and secret to https://us.infisical.com/api/v1/auth/universal-auth/login and use the returned Bearer token on later calls.
- Its examples create (POST), update (PATCH) and delete (DELETE) secrets on /api/v4/secrets, so running them changes the target project.
- Hosts named: us.infisical.com, eu.infisical.com, or a self-hosted domain.

### Cost model

The skill is MIT-licensed, copyright 2026 Infisical Inc. SKILL.md says Infisical Cloud rate limits vary by plan and names no price.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [skills/infisical-api/SKILL.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api/SKILL.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api/SKILL.md Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites
- [README.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md Supports: install.command, install.sourceUrl, install.steps, compatibility, summary
- [LICENSE at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE Supports: license, publisher, access.cost
- [.claude-plugin/marketplace.json at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json Supports: install.steps
- [skills/infisical-api directory at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api) Checked 2026-10-21 https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-api Supports: access.permissions, review.findings
- [Last commit touching skills/infisical-api at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be) Checked 2026-10-21 https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be Supports: limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Infisical Agent Guide ↗ Infisical skill for configuring the Infisical Agent, a client daemon that authenticates, renews tokens and renders secrets into files through Go templates.](/skills/infisical-agent/)[### Infisical Dynamic Secrets Guide ↗ Infisical skill for configuring dynamic secrets: short-lived credentials created per lease for databases, cloud IAM, SSH certificates, Kubernetes service accounts and other providers.](/skills/infisical-dynamic-secrets/)[### Infisical Secret Rotation Guide ↗ Infisical skill for rotating credentials that already exist in a third-party system on a fixed interval and writing the new values back into Infisical secrets.](/skills/infisical-secret-rotation/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
