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

ActionWhat it does
Create folderCreate a folder in an environment.
Create secretAdd a secret to a folder.
Create tagAdd a tag to a project.
Delete folderDelete a folder.
Delete secretDelete a secret from a folder.
Delete tagDelete a tag.
Get projectGet one project with its environments and their slugs.
Get secretRead one secret with its value, comment, tags and version.
List foldersList the folders in a folder of an environment, or all the folders under it.
List projectsList the secret-management projects the machine identity belongs to, with their environments.
List secretsList the secrets in a folder, optionally with the folders under it, filtered by tag or by words in the name.
List tagsList a project's tags, which label secrets.
Update folderRename a folder or change its description.
Update secretChange a secret's value, name, comment or tags.
Update tagRename a tag or change its colour.

Create folder

Create a folder in an environment.

Inputs

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
NamenametextRequired
The folder's name, with no spaces or slashes, such as billing.
Inside foldersecret_pathtext
The folder to create it in. Leave empty for the top of the environment (/).
Descriptiondescriptiontext
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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
Foldersecret_pathtext
The folder the secrets are in. Leave empty for the top of the environment (/).
Namesecret_nametextRequired
The new secret's name, with no spaces, such as STRIPE_API_KEY.
ValuevaluetextRequired
The secret's value.
Commentcommenttext
A note about the secret, shown in Infisical.
Tagstag_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
NameslugtextRequired
The tag's name: lowercase letters, numbers and hyphens, such as billing.
Colourcolortext
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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
FolderfoldertextRequired
The folder, by its full path such as /apps/billing.
Delete contents toodelete_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
Foldersecret_pathtext
The folder the secrets are in. Leave empty for the top of the environment (/).
Secretsecret_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
TagtagtextRequired
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

Projectproject_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
Foldersecret_pathtext
The folder the secrets are in. Leave empty for the top of the environment (/).
Secretsecret_nametextRequired
The secret. Pick one, or give its name from an earlier step.
Versionversionnumber
An earlier version's number. Leave empty for the current one.At least 1.
Fill in referencesexpand_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
In foldersecret_pathtext
The folder to look in. Leave empty for the top of the environment (/).
Include subfoldersrecursivetrue/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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
Foldersecret_pathtext
The folder the secrets are in. Leave empty for the top of the environment (/).
Include subfoldersrecursivetrue/false
Also list the secrets in the folders under it.
Include valuesinclude_valuestrue/false
Return each secret's value too. Off by default, so names only reach the run's history.
Only taggedtag_slugslist
Only secrets with all of these tags.
Name containssearchtext
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

Projectproject_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
FolderfoldertextRequired
The folder, by its full path such as /apps/billing.
New namenametext
Rename the folder. Leave empty to keep its name.
New descriptiondescriptiontext
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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
EnvironmentenvironmenttextRequired
The project's environment, such as Development (dev) or Production (prod).
Foldersecret_pathtext
The folder the secrets are in. Leave empty for the top of the environment (/).
Secretsecret_nametextRequired
The secret. Pick one, or give its name from an earlier step.
New valuevaluetext
The secret's new value. Leave empty to keep it.
New namenew_nametext
Rename the secret. Leave empty to keep its name.
New commentcommenttext
Replace the comment. Leave empty to keep it.
Tagstag_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

Projectproject_idtextRequired
The Infisical project. Pick one, or give its id from an earlier step.
TagtagtextRequired
The tag. Pick one, or give its name.
New nameslugtext
Rename the tag. Leave empty to keep its name.
Colourcolortext
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"
  }
}

On this page