Manage secrets with Infisical
Integrate Infisical into your workflow. List, get, create, update, and delete secrets across project environments.
List all secrets in a project environment. Returns secret keys, values, comments, tags, and metadata.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiKey | string | Sí | Infisical API token |
baseUrl | string | No | Infisical instance URL (default: "https://us.infisical.com"\). Use "https://eu.infisical.com" for EU Cloud or your dedicated Infisical base URL. |
projectId | string | Sí | The ID of the project to list secrets from |
environment | string | Sí | The environment slug (e.g., "dev", "staging", "prod") |
secretPath | string | No | The path of the secrets (default: "/") |
recursive | boolean | No | Whether to fetch secrets recursively from subdirectories |
expandSecretReferences | boolean | No | Whether to expand secret references (default: true) |
viewSecretValue | boolean | No | Whether to include secret values in the response (default: true) |
includeImports | boolean | No | Whether to include imported secrets (default: true) |
tagSlugs | string | No | Comma-separated tag slugs to filter secrets by |
| Parámetro | Tipo | Descripción |
|---|
secrets | array | Array of secrets |
↳ id | string | Secret ID |
↳ workspace | string | Workspace/project ID |
↳ secretKey | string | Secret name/key |
↳ secretValue | string | Secret value |
↳ secretComment | string | Secret comment |
↳ secretPath | string | Secret path |
↳ version | number | Secret version |
↳ type | string | Secret type (shared or personal) |
↳ environment | string | Environment slug |
↳ tags | array | Tags attached to the secret |
↳ id | string | Tag ID |
↳ slug | string | Tag slug |
↳ color | string | Tag color |
↳ name | string | Tag name |
↳ secretMetadata | array | Custom metadata key-value pairs |
↳ key | string | Metadata key |
↳ value | string | Metadata value |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
count | number | Total number of secrets returned |
Retrieve a single secret by name from a project environment.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiKey | string | Sí | Infisical API token |
baseUrl | string | No | Infisical instance URL (default: "https://us.infisical.com"\). Use "https://eu.infisical.com" for EU Cloud or your dedicated Infisical base URL. |
projectId | string | Sí | The ID of the project |
environment | string | Sí | The environment slug (e.g., "dev", "staging", "prod") |
secretName | string | Sí | The name of the secret to retrieve |
secretPath | string | No | The path of the secret (default: "/") |
version | number | No | Specific version of the secret to retrieve |
type | string | No | Secret type: "shared" or "personal" (default: "shared") |
viewSecretValue | boolean | No | Whether to include the secret value in the response (default: true) |
expandSecretReferences | boolean | No | Whether to expand secret references (default: true) |
| Parámetro | Tipo | Descripción |
|---|
secret | object | The retrieved secret |
↳ id | string | Secret ID |
↳ workspace | string | Workspace/project ID |
↳ secretKey | string | Secret name/key |
↳ secretValue | string | Secret value |
↳ secretComment | string | Secret comment |
↳ secretPath | string | Secret path |
↳ version | number | Secret version |
↳ type | string | Secret type (shared or personal) |
↳ environment | string | Environment slug |
↳ tags | array | Tags attached to the secret |
↳ id | string | Tag ID |
↳ slug | string | Tag slug |
↳ color | string | Tag color |
↳ name | string | Tag name |
↳ secretMetadata | array | Custom metadata key-value pairs |
↳ key | string | Metadata key |
↳ value | string | Metadata value |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
Create a new secret in a project environment.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiKey | string | Sí | Infisical API token |
baseUrl | string | No | Infisical instance URL (default: "https://us.infisical.com"\). Use "https://eu.infisical.com" for EU Cloud or your dedicated Infisical base URL. |
projectId | string | Sí | The ID of the project |
environment | string | Sí | The environment slug (e.g., "dev", "staging", "prod") |
secretName | string | Sí | The name of the secret to create |
secretValue | string | Sí | The value of the secret |
secretPath | string | No | The path for the secret (default: "/") |
secretComment | string | No | A comment for the secret |
type | string | No | Secret type: "shared" or "personal" (default: "shared") |
tagIds | string | No | Comma-separated tag IDs to attach to the secret |
| Parámetro | Tipo | Descripción |
|---|
secret | object | The created secret |
↳ id | string | Secret ID |
↳ workspace | string | Workspace/project ID |
↳ secretKey | string | Secret name/key |
↳ secretValue | string | Secret value |
↳ secretComment | string | Secret comment |
↳ secretPath | string | Secret path |
↳ version | number | Secret version |
↳ type | string | Secret type (shared or personal) |
↳ environment | string | Environment slug |
↳ tags | array | Tags attached to the secret |
↳ id | string | Tag ID |
↳ slug | string | Tag slug |
↳ color | string | Tag color |
↳ name | string | Tag name |
↳ secretMetadata | array | Custom metadata key-value pairs |
↳ key | string | Metadata key |
↳ value | string | Metadata value |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
Update an existing secret in a project environment.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiKey | string | Sí | Infisical API token |
baseUrl | string | No | Infisical instance URL (default: "https://us.infisical.com"\). Use "https://eu.infisical.com" for EU Cloud or your dedicated Infisical base URL. |
projectId | string | Sí | The ID of the project |
environment | string | Sí | The environment slug (e.g., "dev", "staging", "prod") |
secretName | string | Sí | The name of the secret to update |
secretValue | string | No | The new value for the secret |
secretPath | string | No | The path of the secret (default: "/") |
secretComment | string | No | A comment for the secret |
newSecretName | string | No | New name for the secret (to rename it) |
type | string | No | Secret type: "shared" or "personal" (default: "shared") |
tagIds | string | No | Comma-separated tag IDs to set on the secret |
| Parámetro | Tipo | Descripción |
|---|
secret | object | The updated secret |
↳ id | string | Secret ID |
↳ workspace | string | Workspace/project ID |
↳ secretKey | string | Secret name/key |
↳ secretValue | string | Secret value |
↳ secretComment | string | Secret comment |
↳ secretPath | string | Secret path |
↳ version | number | Secret version |
↳ type | string | Secret type (shared or personal) |
↳ environment | string | Environment slug |
↳ tags | array | Tags attached to the secret |
↳ id | string | Tag ID |
↳ slug | string | Tag slug |
↳ color | string | Tag color |
↳ name | string | Tag name |
↳ secretMetadata | array | Custom metadata key-value pairs |
↳ key | string | Metadata key |
↳ value | string | Metadata value |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
Delete a secret from a project environment.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
apiKey | string | Sí | Infisical API token |
baseUrl | string | No | Infisical instance URL (default: "https://us.infisical.com"\). Use "https://eu.infisical.com" for EU Cloud or your dedicated Infisical base URL. |
projectId | string | Sí | The ID of the project |
environment | string | Sí | The environment slug (e.g., "dev", "staging", "prod") |
secretName | string | Sí | The name of the secret to delete |
secretPath | string | No | The path of the secret (default: "/") |
type | string | No | Secret type: "shared" or "personal" (default: "shared") |
| Parámetro | Tipo | Descripción |
|---|
secret | object | The deleted secret |
↳ id | string | Secret ID |
↳ workspace | string | Workspace/project ID |
↳ secretKey | string | Secret name/key |
↳ secretValue | string | Secret value |
↳ secretComment | string | Secret comment |
↳ secretPath | string | Secret path |
↳ version | number | Secret version |
↳ type | string | Secret type (shared or personal) |
↳ environment | string | Environment slug |
↳ tags | array | Tags attached to the secret |
↳ id | string | Tag ID |
↳ slug | string | Tag slug |
↳ color | string | Tag color |
↳ name | string | Tag name |
↳ secretMetadata | array | Custom metadata key-value pairs |
↳ key | string | Metadata key |
↳ value | string | Metadata value |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |