Skip to content

Environment and keys API ​

Environment settings control queue and runtime behavior. Keys control access to protected endpoints. These are usually administrator tasks.

Runtime settings ​

MethodPathPurpose
GET/api/environment/settingsRead current runtime settings
PUT/api/environment/settingsSave runtime settings

Fields include queue capacity, concurrency, wait timeout, and library upload limits. GET first, retain fields you are not changing, then PUT the complete settings.

API keys ​

MethodPathPurpose
POST/api/environment/settings/mcp-keys/setupFirst administrator key; local only
GET/api/environment/settings/mcp-keysList key metadata
POST/api/environment/settings/mcp-keysCreate a key
POST/api/environment/settings/mcp-keys/{id}/rotateRotate a key
DELETE/api/environment/settings/mcp-keys/{id}Revoke a key

Except for initial setup, key management requires an administrator key even if ordinary REST authentication is off. A new key can have project scope, name, permissions, and expiry. The full secret is shown once after creation or rotation; listing will not return it again.

For a program that invokes flows, grant only the needed run.execute and run.read permissions. See URLs, keys, and errors for authentication behavior.

SereinFlow user and developer documentation