Skip to main content
POST
/
api
/
v2
/
workspace
cURL
curl --request POST \
  --url https://us.infisical.com/api/v2/workspace \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectName": "<string>",
  "projectDescription": "<string>",
  "slug": "<string>",
  "kmsKeyId": "<string>",
  "template": "default",
  "type": "secret-manager",
  "shouldCreateDefaultEnvs": true,
  "hasDeleteProtection": false
}
'
{
  "project": {
    "id": "<string>",
    "name": "<string>",
    "type": "<string>",
    "slug": "<string>",
    "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "_id": "<string>",
    "environments": [
      {
        "name": "<string>",
        "slug": "<string>",
        "id": "<string>"
      }
    ],
    "description": "<string>",
    "defaultProduct": "<string>",
    "autoCapitalization": false,
    "version": 1,
    "upgradeStatus": "<string>",
    "pitVersionLimit": 10,
    "kmsCertificateKeyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "auditLogsRetentionDays": 123,
    "hasDeleteProtection": false,
    "secretSharing": true,
    "showSnapshotsLegacy": false,
    "secretDetectionIgnoreValues": [
      "<string>"
    ],
    "enforceEncryptedSecretManagerSecretMetadata": true,
    "kmsSecretManagerKeyId": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://infisical-docs-self-host-infra.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

An access token in Infisical

Body

application/json
​
projectName
string
required

The name of the project to create.

​
projectDescription
string

An optional description label for the project.

​
slug
string

An optional slug for the project.

Required string length: 5 - 36
​
kmsKeyId
string
​
template
string
default:default

The name of the project template, if specified, to apply to this project.

Required string length: 1 - 64
​
type
enum<string>
default:secret-manager
Available options:
secret-manager,
cert-manager,
kms,
ssh,
secret-scanning,
pam,
ai
​
shouldCreateDefaultEnvs
boolean
default:true
​
hasDeleteProtection
boolean
default:false

Response

Default Response

​
project
object
required