Create secret

POST

/secret-store/stores/:store_id/secrets

Creates a secret in a store. Requires scope: secret-store.write.

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

store_idstringRequired

Secret store ID.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

Request

This endpoint expects an object.

secret_namestringRequiredformat: "^[a-z0-9][a-z0-9-]{1,63}$"2-64 characters

Unique name for the secret within the store. Lowercase alphanumeric and hyphens only.

valuemap from strings to anyRequired

Key-value pairs containing the secret data.

Response

Secret created successfully.

idstringOptional

organization_idstringOptional

workspace_idstringOptional

store_idstringOptional

store_keystringOptional

secret_namestringOptional

statusenumOptional

created_atdatetimeOptional

updated_atdatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

$	curl -X POST "https://api.ibee.ai/v1/secret-store/stores/019f1e4b-3edd-72cf-b90e-26864ba2f283/secrets?workspace_id=710995" \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"secret_name": "database-url",
>	"value": {
>	"url": "postgres://user:pass@host:5432/mydb"
>	}
>	}'

1	{
2	"id": "secret_123",
3	"organization_id": "250612",
4	"workspace_id": "907479",
5	"store_id": "store_123",
6	"store_key": "production-secrets",
7	"secret_name": "database-url",
8	"status": "active",
9	"created_at": "2024-01-15T09:30:00Z",
10	"updated_at": "2024-01-15T09:30:00Z"
11	}