POST
/
api
/
v3
/
secrets
/
raw
/
{secretName}
curl --request POST \
  --url https://us.infisical.com/api/v3/secrets/raw/{secretName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "workspaceId": "<string>",
  "environment": "<string>",
  "secretPath": "/",
  "secretValue": "<string>",
  "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>",
    "secretReminderNote": "<string>",
    "secretReminderRepeatDays": 123,
    "skipMultilineEncoding": false,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "actor": {
      "actorId": "<string>",
      "actorType": "<string>",
      "name": "<string>",
      "membershipId": "<string>"
    }
  }
}

Authorizations

​
Authorization
string
header
required

An access token in Infisical

Path Parameters

​
secretName
string
required

The name of the secret to create.

Minimum length: 1

Body

application/json
​
workspaceId
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[]
​
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 length: 1024

Response

200
application/json
Default Response
​
secret
object
required

Was this page helpful?

Suggest editsRaise issue