Skip to main content
POST
/
api
/
v3
/
secrets
/
raw
/
{secretName}
cURL
curl --request POST \
  --url https://us.infisical.com/api/v3/secrets/raw/{secretName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "environment": "<string>",
  "secretValue": "<string>",
  "workspaceId": "<string>",
  "projectSlug": "<string>",
  "secretPath": "/",
  "secretComment": "",
  "secretMetadata": [
    {
      "key": "<string>",
      "value": ""
    }
  ],
  "tagIds": [
    "<string>"
  ],
  "skipMultilineEncoding": true,
  "type": "shared",
  "secretReminderRepeatDays": 123,
  "secretReminderNote": "<string>"
}
'
{
  "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
​
environment
string
required

The slug of the environment to create the secret in.

​
secretValue
string
required

The value of the secret to create.

​
workspaceId
string

The ID of the project to create the secret in.

​
projectSlug
string

The slug of the project to create the secret in.

​
secretPath
string
default:/

The path to create the secret in.

​
secretComment
string
default:""

Attach a comment to the secret.

​
secretMetadata
object[]
​
tagIds
string[]

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

​
skipMultilineEncoding
boolean

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

Default Response

​
secret
object
required