Infisical
App · 15 actions
Read and manage the secrets in your Infisical projects: get, create, update and delete secrets, folders and tags, and start a workflow when a secret changes.
Actions
| Action | What it does |
|---|---|
| Create folder | Create a folder in an environment. |
| Create secret | Add a secret to a folder. |
| Create tag | Add a tag to a project. |
| Delete folder | Delete a folder. |
| Delete secret | Delete a secret from a folder. |
| Delete tag | Delete a tag. |
| Get project | Get one project with its environments and their slugs. |
| Get secret | Read one secret with its value, comment, tags and version. |
| List folders | List the folders in a folder of an environment, or all the folders under it. |
| List projects | List the secret-management projects the machine identity belongs to, with their environments. |
| List secrets | List the secrets in a folder, optionally with the folders under it, filtered by tag or by words in the name. |
| List tags | List a project's tags, which label secrets. |
| Update folder | Rename a folder or change its description. |
| Update secret | Change a secret's value, name, comment or tags. |
| Update tag | Rename a tag or change its colour. |
Create folder
Create a folder in an environment.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Name
nametextRequired - The folder's name, with no spaces or slashes, such as billing.
- Inside folder
secret_pathtext - The folder to create it in. Leave empty for the top of the environment (/).
- Description
descriptiontext - A note about what the folder is for.
Outputs
folderobject- The folder
Example output
{
"folder": {
"created_at": "2026-11-12T06:40:01+00:00",
"description": "Billing service secrets",
"id": "52daabc5-5a58-4039-ad96-fb35f0890dc8",
"name": "billing",
"path": "/apps/billing",
"updated_at": "2026-11-12T06:40:01+00:00"
}
}Create secret
Add a secret to a folder. It fails if a secret of that name is already there.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
secret_pathtext - The folder the secrets are in. Leave empty for the top of the environment (/).
- Name
secret_nametextRequired - The new secret's name, with no spaces, such as STRIPE_API_KEY.
- Value
valuetextRequired - The secret's value.
- Comment
commenttext - A note about the secret, shown in Infisical.
- Tags
tag_slugslist - Tags to put on the secret. Pick from the project's tags.
Outputs
secretobject- The secret
Example output
{
"secret": {
"comment": "Used by the billing service",
"created_at": "2026-11-12T06:39:43+00:00",
"environment": "dev",
"id": "13e64be9-d84f-4046-aad1-e12917795b77",
"metadata": [
{
"key": "owner",
"value": "payments"
}
],
"name": "STRIPE_API_KEY",
"path": "/apps/billing",
"project_id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"tags": [
"billing"
],
"updated_at": "2026-11-12T06:40:18+00:00",
"value": "example-billing-api-key",
"value_hidden": false,
"version": 1
}
}Create tag
Add a tag to a project.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Name
slugtextRequired - The tag's name: lowercase letters, numbers and hyphens, such as billing.
- Colour
colortext - The tag's colour in Infisical. Defaults to blue.One of:
#3b82f6(Blue (default)),#10b981(Green),#ef4444(Red),#f59e0b(Amber),#8b5cf6(Purple),#ec4899(Pink),#64748b(Grey).
Outputs
tagobject- The tag
Example output
{
"tag": {
"color": "#3b82f6",
"created_at": "2026-11-12T06:39:52+00:00",
"id": "189d1737-af68-4335-a18e-6a721537b38c",
"slug": "billing",
"updated_at": "2026-11-12T06:39:52+00:00"
}
}Delete folder
Delete a folder. Infisical refuses if it still holds secrets or folders, unless you turn on Delete contents too.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
foldertextRequired - The folder, by its full path such as /apps/billing.
- Delete contents too
delete_contentstrue/false - Also delete every secret and folder inside it, for good. Off by default.
Outputs
deletedtrue/false- Always true once deleted
idtext- The id of the folder deleted
pathtext- The path of the folder deleted
Example output
{
"deleted": true,
"id": "52daabc5-5a58-4039-ad96-fb35f0890dc8",
"path": "/apps/billing"
}Delete secret
Delete a secret from a folder. Infisical keeps no copy to restore from this action.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
secret_pathtext - The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret
secret_nametextRequired - The secret. Pick one, or give its name from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
environmenttext- The environment it was in
idtext- The id of the secret deleted
nametext- The name of the secret deleted
pathtext- The folder it was in
Example output
{
"deleted": true,
"environment": "dev",
"id": "13e64be9-d84f-4046-aad1-e12917795b77",
"name": "STRIPE_API_KEY",
"path": "/apps/billing"
}Delete tag
Delete a tag. Secrets that had it lose the label.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Tag
tagtextRequired - The tag. Pick one, or give its name.
Outputs
deletedtrue/false- Always true once deleted
idtext- The id of the tag deleted
slugtext- The name of the tag deleted
Example output
{
"deleted": true,
"id": "189d1737-af68-4335-a18e-6a721537b38c",
"slug": "billing"
}Get project
Get one project with its environments and their slugs.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
Outputs
projectobject- The project
Example output
{
"project": {
"created_at": "2026-11-12T06:38:13+00:00",
"description": "",
"environments": [
{
"id": "3f6806b2-995a-41fe-85c6-9ebba1b57c24",
"name": "Development",
"slug": "dev"
},
{
"id": "7dd3dc15-60dd-469a-925d-e02f1e6804a2",
"name": "Production",
"slug": "prod"
}
],
"id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"name": "Payments",
"slug": "payments-ab12",
"type": "secret-manager",
"updated_at": "2026-11-12T06:38:13+00:00"
}
}Get secret
Read one secret with its value, comment, tags and version. Give a version number to read an earlier one.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
secret_pathtext - The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret
secret_nametextRequired - The secret. Pick one, or give its name from an earlier step.
- Version
versionnumber - An earlier version's number. Leave empty for the current one.At least 1.
- Fill in references
expand_referencestrue/false - Replace references to other secrets in the value (like ${prod.db.PASSWORD}) with what they point to.
Outputs
secretobject- The secret
Example output
{
"secret": {
"comment": "Used by the billing service",
"created_at": "2026-11-12T06:39:43+00:00",
"environment": "dev",
"id": "13e64be9-d84f-4046-aad1-e12917795b77",
"metadata": [
{
"key": "owner",
"value": "payments"
}
],
"name": "STRIPE_API_KEY",
"path": "/apps/billing",
"project_id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"tags": [
"billing"
],
"updated_at": "2026-11-12T06:40:18+00:00",
"value": "example-billing-api-key",
"value_hidden": false,
"version": 2
}
}List folders
List the folders in a folder of an environment, or all the folders under it.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- In folder
secret_pathtext - The folder to look in. Leave empty for the top of the environment (/).
- Include subfolders
recursivetrue/false - Also list the folders inside those folders.
Outputs
countnumber- How many were returned
folderslist- The folders
pathtext- The folder searched
Example output
{
"count": 1,
"folders": [
{
"created_at": "2026-11-12T06:40:01+00:00",
"description": "Billing service secrets",
"id": "52daabc5-5a58-4039-ad96-fb35f0890dc8",
"name": "billing",
"path": "/apps/billing",
"updated_at": "2026-11-12T06:40:01+00:00"
}
],
"path": "/apps"
}List projects
List the secret-management projects the machine identity belongs to, with their environments.
Inputs
None.
Outputs
countnumber- How many were returned
projectslist- The projects
Example output
{
"count": 1,
"projects": [
{
"created_at": "2026-11-12T06:38:13+00:00",
"description": "",
"environments": [
{
"id": "3f6806b2-995a-41fe-85c6-9ebba1b57c24",
"name": "Development",
"slug": "dev"
},
{
"id": "7dd3dc15-60dd-469a-925d-e02f1e6804a2",
"name": "Production",
"slug": "prod"
}
],
"id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"name": "Payments",
"slug": "payments-ab12",
"type": "secret-manager",
"updated_at": "2026-11-12T06:38:13+00:00"
}
]
}List secrets
List the secrets in a folder, optionally with the folders under it, filtered by tag or by words in the name. Values are left out unless you turn on Include values.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
secret_pathtext - The folder the secrets are in. Leave empty for the top of the environment (/).
- Include subfolders
recursivetrue/false - Also list the secrets in the folders under it.
- Include values
include_valuestrue/false - Return each secret's value too. Off by default, so names only reach the run's history.
- Only tagged
tag_slugslist - Only secrets with all of these tags.
- Name contains
searchtext - Only secrets whose name contains these letters. Not case sensitive.
Outputs
countnumber- How many were returned
pathtext- The folder searched
secretslist- The secrets
Example output
{
"count": 1,
"path": "/apps/billing",
"secrets": [
{
"comment": "Used by the billing service",
"created_at": "2026-11-12T06:39:43+00:00",
"environment": "dev",
"id": "13e64be9-d84f-4046-aad1-e12917795b77",
"metadata": [
{
"key": "owner",
"value": "payments"
}
],
"name": "STRIPE_API_KEY",
"path": "/apps/billing",
"project_id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"tags": [
"billing"
],
"updated_at": "2026-11-12T06:40:18+00:00",
"value": "",
"value_hidden": true,
"version": 2
}
]
}List tags
List a project's tags, which label secrets.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
Outputs
countnumber- How many were returned
tagslist- The tags
Example output
{
"count": 1,
"tags": [
{
"color": "#3b82f6",
"created_at": "2026-11-12T06:39:52+00:00",
"id": "189d1737-af68-4335-a18e-6a721537b38c",
"slug": "billing",
"updated_at": "2026-11-12T06:39:52+00:00"
}
]
}Update folder
Rename a folder or change its description.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
foldertextRequired - The folder, by its full path such as /apps/billing.
- New name
nametext - Rename the folder. Leave empty to keep its name.
- New description
descriptiontext - Replace the description. Leave empty to keep it.
Outputs
folderobject- The folder
Example output
{
"folder": {
"created_at": "2026-11-12T06:40:01+00:00",
"description": "Billing service secrets",
"id": "52daabc5-5a58-4039-ad96-fb35f0890dc8",
"name": "billing",
"path": "/apps/billing",
"updated_at": "2026-11-12T06:40:01+00:00"
}
}Update secret
Change a secret's value, name, comment or tags. What you leave empty stays as it is.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Environment
environmenttextRequired - The project's environment, such as Development (dev) or Production (prod).
- Folder
secret_pathtext - The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret
secret_nametextRequired - The secret. Pick one, or give its name from an earlier step.
- New value
valuetext - The secret's new value. Leave empty to keep it.
- New name
new_nametext - Rename the secret. Leave empty to keep its name.
- New comment
commenttext - Replace the comment. Leave empty to keep it.
- Tags
tag_slugslist - Replace the secret's tags with these. Leave empty to keep them.
Outputs
secretobject- The secret
Example output
{
"secret": {
"comment": "Used by the billing service",
"created_at": "2026-11-12T06:39:43+00:00",
"environment": "dev",
"id": "13e64be9-d84f-4046-aad1-e12917795b77",
"metadata": [
{
"key": "owner",
"value": "payments"
}
],
"name": "STRIPE_API_KEY",
"path": "/apps/billing",
"project_id": "64eb3694-970b-4cb2-b237-0b90ba0d90ae",
"tags": [
"billing"
],
"updated_at": "2026-11-12T06:40:18+00:00",
"value": "example-billing-api-key",
"value_hidden": false,
"version": 2
}
}Update tag
Rename a tag or change its colour.
Inputs
- Project
project_idtextRequired - The Infisical project. Pick one, or give its id from an earlier step.
- Tag
tagtextRequired - The tag. Pick one, or give its name.
- New name
slugtext - Rename the tag. Leave empty to keep its name.
- Colour
colortext - The tag's colour in Infisical. Defaults to blue.One of:
#3b82f6(Blue (default)),#10b981(Green),#ef4444(Red),#f59e0b(Amber),#8b5cf6(Purple),#ec4899(Pink),#64748b(Grey).
Outputs
tagobject- The tag
Example output
{
"tag": {
"color": "#3b82f6",
"created_at": "2026-11-12T06:39:52+00:00",
"id": "189d1737-af68-4335-a18e-6a721537b38c",
"slug": "billing",
"updated_at": "2026-11-12T06:39:52+00:00"
}
}