Get secret value

GET

/secret-store/secrets/:secret_id/value

Gets the latest value for a secret. Requires scope: secret-store.read.

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

secret_idstringRequired

Secret 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.

Response

Secret value returned successfully.

idstringOptional

secret_namestringOptional

datamap from strings to anyOptional

Key-value pairs containing the secret data.

metadatamap from strings to anyOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

1	{
2	"id": "secret_123",
3	"secret_name": "database-url",
4	"data": {
5	"url": "postgres://user:pass@host:5432/mydb"
6	},
7	"metadata": {
8	"version": 1,
9	"created_time": "2026-06-29T00:00:00Z"
10	}
11	}