# Infisical

> 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.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/infisical

## Actions

### Create folder

Create a folder in an environment.

**Inputs**

- Project (`project_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Name (`name`, text, required): The folder's name, with no spaces or slashes, such as billing.
- Inside folder (`secret_path`, text): The folder to create it in. Leave empty for the top of the environment (/).
- Description (`description`, text): A note about what the folder is for.

**Outputs**

- `folder` (object): The folder

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`secret_path`, text): The folder the secrets are in. Leave empty for the top of the environment (/).
- Name (`secret_name`, text, required): The new secret's name, with no spaces, such as STRIPE_API_KEY.
- Value (`value`, text, required): The secret's value.
- Comment (`comment`, text): A note about the secret, shown in Infisical.
- Tags (`tag_slugs`, list): Tags to put on the secret. Pick from the project's tags.

**Outputs**

- `secret` (object): The secret

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Name (`slug`, text, required): The tag's name: lowercase letters, numbers and hyphens, such as billing.
- Colour (`color`, text): 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**

- `tag` (object): The tag

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`folder`, text, required): The folder, by its full path such as /apps/billing.
- Delete contents too (`delete_contents`, true/false): Also delete every secret and folder inside it, for good. Off by default.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `id` (text): The id of the folder deleted
- `path` (text): The path of the folder deleted

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`secret_path`, text): The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret (`secret_name`, text, required): The secret. Pick one, or give its name from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `environment` (text): The environment it was in
- `id` (text): The id of the secret deleted
- `name` (text): The name of the secret deleted
- `path` (text): The folder it was in

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Tag (`tag`, text, required): The tag. Pick one, or give its name.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `id` (text): The id of the tag deleted
- `slug` (text): The name of the tag deleted

**Example output**

```json
{
  "deleted": true,
  "id": "189d1737-af68-4335-a18e-6a721537b38c",
  "slug": "billing"
}
```

### Get project

Get one project with its environments and their slugs.

**Inputs**

- Project (`project_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.

**Outputs**

- `project` (object): The project

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`secret_path`, text): The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret (`secret_name`, text, required): The secret. Pick one, or give its name from an earlier step.
- Version (`version`, number): An earlier version's number. Leave empty for the current one. At least 1.
- Fill in references (`expand_references`, true/false): Replace references to other secrets in the value (like ${prod.db.PASSWORD}) with what they point to.

**Outputs**

- `secret` (object): The secret

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- In folder (`secret_path`, text): The folder to look in. Leave empty for the top of the environment (/).
- Include subfolders (`recursive`, true/false): Also list the folders inside those folders.

**Outputs**

- `count` (number): How many were returned
- `folders` (list): The folders
- `path` (text): The folder searched

**Example output**

```json
{
  "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**

- `count` (number): How many were returned
- `projects` (list): The projects

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`secret_path`, text): The folder the secrets are in. Leave empty for the top of the environment (/).
- Include subfolders (`recursive`, true/false): Also list the secrets in the folders under it.
- Include values (`include_values`, true/false): Return each secret's value too. Off by default, so names only reach the run's history.
- Only tagged (`tag_slugs`, list): Only secrets with all of these tags.
- Name contains (`search`, text): Only secrets whose name contains these letters. Not case sensitive.

**Outputs**

- `count` (number): How many were returned
- `path` (text): The folder searched
- `secrets` (list): The secrets

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many were returned
- `tags` (list): The tags

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`folder`, text, required): The folder, by its full path such as /apps/billing.
- New name (`name`, text): Rename the folder. Leave empty to keep its name.
- New description (`description`, text): Replace the description. Leave empty to keep it.

**Outputs**

- `folder` (object): The folder

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Environment (`environment`, text, required): The project's environment, such as Development (dev) or Production (prod).
- Folder (`secret_path`, text): The folder the secrets are in. Leave empty for the top of the environment (/).
- Secret (`secret_name`, text, required): The secret. Pick one, or give its name from an earlier step.
- New value (`value`, text): The secret's new value. Leave empty to keep it.
- New name (`new_name`, text): Rename the secret. Leave empty to keep its name.
- New comment (`comment`, text): Replace the comment. Leave empty to keep it.
- Tags (`tag_slugs`, list): Replace the secret's tags with these. Leave empty to keep them.

**Outputs**

- `secret` (object): The secret

**Example output**

```json
{
  "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_id`, text, required): The Infisical project. Pick one, or give its id from an earlier step.
- Tag (`tag`, text, required): The tag. Pick one, or give its name.
- New name (`slug`, text): Rename the tag. Leave empty to keep its name.
- Colour (`color`, text): 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**

- `tag` (object): The tag

**Example output**

```json
{
  "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"
  }
}
```
