Create secret | Instabase AI Hub Documentation

Commercial & Enterprise

Create a new secret in this organization.

Only organization admins can create secrets.

<span class="badge">Commercial & Enterprise</span> Create a new secret in this organization. <Note>Only organization admins can create secrets.</Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

IB-ContextstringOptional

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See Authorization and context identification for details.

Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See [Authorization and context identification](/api-sdk/authorization#ib-context-header) for details.

Request

This endpoint expects an object.

aliasstringRequired

Name of the secret.

valuestringRequired

Content of the secret.

allowed_workspaces_typeenumRequired

Which workspaces in this organization are allowed to use this secret in custom functions.

Allowed values:

descriptionstringOptional

Description of the secret.

allowed_workspaceslist of stringsOptional

Which workspaces are allowed to use this secret, if only some are allowed.

Response

Secret created successfully.

1	curl -X POST "${API_ROOT}/v2/aihub/secrets" \
2	-H "Authorization: Bearer ${API_TOKEN}" \
3	-H "IB-Context: ${IB_CONTEXT}" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"alias": "my_secret",
7	"description": "Sample secret",
8	"value": "my password",
9	"allowed_workspaces_type": "SOME",
10	"allowed_workspaces": ["workspace1", "workspace2"]
11	}'