Use Infisical to list, read, create, update, or delete secrets in a project environment. Configure the API key, project ID, environment slug, and any secret path required by the selected operation.
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.
Inputs and outputsParameter Type Required Description apiKeystring Yes Infisical API token baseUrlstring No Infisical instance URL (default: "https://us.infisical.com "). Use "https://eu.infisical.com " for EU Cloud or your self-hosted URL. projectIdstring Yes The ID of the project to list secrets from environmentstring Yes The environment slug (e.g., "dev", "staging", "prod") secretPathstring No The path of the secrets (default: "/") recursiveboolean No Whether to fetch secrets recursively from subdirectories expandSecretReferencesboolean No Whether to expand secret references (default: true) viewSecretValueboolean No Whether to include secret values in the response (default: true) includeImportsboolean No Whether to include imported secrets (default: true) tagSlugsstring No Comma-separated tag slugs to filter secrets by
Parameter Type Description secretsarray 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 ↳ secretValueHidden boolean Whether the secret value was hidden in the response ↳ isRotatedSecret boolean Whether the secret is managed by secret rotation ↳ rotationId string Secret rotation ID ↳ secretReminderNote string Rotation reminder note ↳ secretReminderRepeatDays number Rotation reminder interval in days ↳ skipMultilineEncoding boolean Whether multiline encoding is skipped for this secret ↳ 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 ↳ isEncrypted boolean Whether the metadata value is encrypted ↳ actor object Identity that last modified the secret ↳ actorId string Actor ID ↳ actorType string Actor type ↳ name string Actor name ↳ membershipId string Membership ID ↳ groupId string Group ID ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp countnumber Total number of secrets returned
Retrieve a single secret by name from a project environment.
Inputs and outputsParameter Type Required Description apiKeystring Yes Infisical API token baseUrlstring No Infisical instance URL (default: "https://us.infisical.com "). Use "https://eu.infisical.com " for EU Cloud or your self-hosted URL. projectIdstring Yes The ID of the project environmentstring Yes The environment slug (e.g., "dev", "staging", "prod") secretNamestring Yes The name of the secret to retrieve secretPathstring No The path of the secret (default: "/") versionnumber No Specific version of the secret to retrieve typestring No Secret type: "shared" or "personal" (default: "shared") viewSecretValueboolean No Whether to include the secret value in the response (default: true) expandSecretReferencesboolean No Whether to expand secret references (default: true)
Parameter Type Description secretobject 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 ↳ secretValueHidden boolean Whether the secret value was hidden in the response ↳ isRotatedSecret boolean Whether the secret is managed by secret rotation ↳ rotationId string Secret rotation ID ↳ secretReminderNote string Rotation reminder note ↳ secretReminderRepeatDays number Rotation reminder interval in days ↳ skipMultilineEncoding boolean Whether multiline encoding is skipped for this secret ↳ 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 ↳ isEncrypted boolean Whether the metadata value is encrypted ↳ actor object Identity that last modified the secret ↳ actorId string Actor ID ↳ actorType string Actor type ↳ name string Actor name ↳ membershipId string Membership ID ↳ groupId string Group ID ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp
Create a new secret in a project environment.
Inputs and outputsParameter Type Required Description apiKeystring Yes Infisical API token baseUrlstring No Infisical instance URL (default: "https://us.infisical.com "). Use "https://eu.infisical.com " for EU Cloud or your self-hosted URL. projectIdstring Yes The ID of the project environmentstring Yes The environment slug (e.g., "dev", "staging", "prod") secretNamestring Yes The name of the secret to create secretValuestring Yes The value of the secret secretPathstring No The path for the secret (default: "/") secretCommentstring No A comment for the secret typestring No Secret type: "shared" or "personal" (default: "shared") tagIdsstring No Comma-separated tag IDs to attach to the secret
Parameter Type Description secretobject 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 ↳ secretValueHidden boolean Whether the secret value was hidden in the response ↳ isRotatedSecret boolean Whether the secret is managed by secret rotation ↳ rotationId string Secret rotation ID ↳ secretReminderNote string Rotation reminder note ↳ secretReminderRepeatDays number Rotation reminder interval in days ↳ skipMultilineEncoding boolean Whether multiline encoding is skipped for this secret ↳ 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 ↳ isEncrypted boolean Whether the metadata value is encrypted ↳ actor object Identity that last modified the secret ↳ actorId string Actor ID ↳ actorType string Actor type ↳ name string Actor name ↳ membershipId string Membership ID ↳ groupId string Group ID ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp
Update an existing secret in a project environment.
Inputs and outputsParameter Type Required Description apiKeystring Yes Infisical API token baseUrlstring No Infisical instance URL (default: "https://us.infisical.com "). Use "https://eu.infisical.com " for EU Cloud or your self-hosted URL. projectIdstring Yes The ID of the project environmentstring Yes The environment slug (e.g., "dev", "staging", "prod") secretNamestring Yes The name of the secret to update secretValuestring No The new value for the secret secretPathstring No The path of the secret (default: "/") secretCommentstring No A comment for the secret newSecretNamestring No New name for the secret (to rename it) typestring No Secret type: "shared" or "personal" (default: "shared") tagIdsstring No Comma-separated tag IDs to set on the secret
Parameter Type Description secretobject 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 ↳ secretValueHidden boolean Whether the secret value was hidden in the response ↳ isRotatedSecret boolean Whether the secret is managed by secret rotation ↳ rotationId string Secret rotation ID ↳ secretReminderNote string Rotation reminder note ↳ secretReminderRepeatDays number Rotation reminder interval in days ↳ skipMultilineEncoding boolean Whether multiline encoding is skipped for this secret ↳ 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 ↳ isEncrypted boolean Whether the metadata value is encrypted ↳ actor object Identity that last modified the secret ↳ actorId string Actor ID ↳ actorType string Actor type ↳ name string Actor name ↳ membershipId string Membership ID ↳ groupId string Group ID ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp
Delete a secret from a project environment.
Inputs and outputsParameter Type Required Description apiKeystring Yes Infisical API token baseUrlstring No Infisical instance URL (default: "https://us.infisical.com "). Use "https://eu.infisical.com " for EU Cloud or your self-hosted URL. projectIdstring Yes The ID of the project environmentstring Yes The environment slug (e.g., "dev", "staging", "prod") secretNamestring Yes The name of the secret to delete secretPathstring No The path of the secret (default: "/") typestring No Secret type: "shared" or "personal" (default: "shared")
Parameter Type Description secretobject 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 ↳ secretValueHidden boolean Whether the secret value was hidden in the response ↳ isRotatedSecret boolean Whether the secret is managed by secret rotation ↳ rotationId string Secret rotation ID ↳ secretReminderNote string Rotation reminder note ↳ secretReminderRepeatDays number Rotation reminder interval in days ↳ skipMultilineEncoding boolean Whether multiline encoding is skipped for this secret ↳ 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 ↳ isEncrypted boolean Whether the metadata value is encrypted ↳ actor object Identity that last modified the secret ↳ actorId string Actor ID ↳ actorType string Actor type ↳ name string Actor name ↳ membershipId string Membership ID ↳ groupId string Group ID ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp