Create

Create secret

POST /api/v4/secrets/{secretName}

cURL

cURL

curl --request POST \
  --url https://us.infisical.com/api/v4/secrets/{secretName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "environment": "<string>",
  "secretValue": "<string>",
  "secretPath": "/",
  "secretComment": "",
  "secretMetadata": [
    {
      "key": "<string>",
      "value": "",
      "isEncrypted": false
    }
  ],
  "tagIds": [
    "<string>"
  ],
  "skipMultilineEncoding": true,
  "type": "shared",
  "secretReminderRepeatDays": 123,
  "secretReminderNote": "<string>"
}
'

200

{
  "secret": {
    "id": "<string>",
    "_id": "<string>",
    "workspace": "<string>",
    "environment": "<string>",
    "version": 123,
    "type": "<string>",
    "secretKey": "<string>",
    "secretValue": "<string>",
    "secretComment": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "secretReminderNote": "<string>",
    "secretReminderRepeatDays": 123,
    "skipMultilineEncoding": false,
    "actor": {
      "actorId": "<string>",
      "actorType": "<string>",
      "name": "<string>",
      "membershipId": "<string>",
      "groupId": "<string>"
    },
    "isRotatedSecret": true,
    "rotationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Authorizations

Authorization · string · header · required

An access token in Infisical

Path Parameters

secretName · string · required

The name of the secret to create.

Minimum string length: 1

Body

application/json

projectId · string · required

The ID of the project to create the secret in.

environment · string · required

The slug of the environment to create the secret in.

secretValue · string · required

The value of the secret to create.

secretPath · string · default: /

The path to create the secret in.

secretComment · string · default: ""

Attach a comment to the secret.

secretMetadata · object[]

Show child attributes

tagIds · string[]

The ID of the tags to be attached to the created secret.

skipMultilineEncoding · boolean | null

Skip multiline encoding for the secret value.

type · enum<string> · default: shared

The type of the secret to create.

Available options: shared, personal

secretReminderRepeatDays · number | null

Interval for secret rotation notifications, measured in days.

secretReminderNote · string | null

Note to be attached in notification email.

Maximum string length: 1024

Response

200

application/json

Default Response

Option 1

Option 2

secret · object · required

Show child attributes