Skip to main content
POST
/
api
/
v2
/
folders
cURL
curl --request POST \
  --url https://us.infisical.com/api/v2/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "projectId": "<string>",
  "environment": "<string>",
  "name": "<string>",
  "path": "/",
  "description": "<string>"
}'
{
  "folder": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "version": 1,
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "envId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "parentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "isReserved": false,
    "description": "<string>",
    "lastSecretModified": "2023-11-07T05:31:56Z",
    "path": "<string>"
  }
}

Authorizations

Authorization
string
header
required

An access token in Infisical

Body

application/json
projectId
string
required

The ID of the project to create the folder in.

environment
string
required

The slug of the environment to create the folder in.

name
string
required

The name of the folder to create.

path
string
default:/

The path of the folder to create.

description
string | null

An optional description label for the folder.

Response

Default Response

folder
object
required