v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Create a Secret

Creates a new secret for the specified project. Secrets are encrypted and stored securely.

post/v1/projects/secrets

Request body

namestring required

The name of the secret.

valuestring required

The secret value to store.

descriptionstring

An optional description of the secret.

tagsstring[]

Optional tags to categorize the secret.

Example request

{
  "name": "API_KEY",
  "value": "super-secret-value",
  "description": "Production API key",
  "tags": [
    "production",
    "api"
  ]
}

Response

Secret created successfully

successboolean

messagestring

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "id": "ed9b5601-f731-441a-8500-d9fc7610ef8f",
    "name": "API_KEY",
    "description": "Production API key",
    "tags": [
      "production",
      "api"
    ],
    "createdAt": "2024-12-15T00:00:00.000Z",
    "updatedAt": "2024-12-15T00:00:00.000Z"
  }
}