Skip to main content
GET
List workspace secrets

Authorizations

Authorization
string
header
required

Workspace API key (wk_). GET endpoints require the Workspace read API scope, POST, PUT, PATCH and DELETE endpoints the Workspace write API scope, and sending or revoking invitations (POST and DELETE /workspaceapi/invites) the Invite members scope. A key stops working when it expires or is disabled.

Response

Success. Empty result sets are also 200.

id
string
required
name
string
required
type
string
required

Secret type, e.g. http, gcp, salesforce.

sanitizedSecret
string
required

Masked display value. The real value never leaves the platform.

fields
object[]
required
allHttpApis
boolean
required

True means agent owners may connect it to any Outbound API.

allowedHttpApis
object[]
required

Outbound APIs agent owners may connect it to. Empty with allHttpApis false: only its managers may.

allMcpTemplates
boolean
required

True means agent owners may connect it to any MCP server from the catalog.

allowedMcpTemplates
object[]
required

Catalog MCP servers agent owners may connect it to. On a server added by URL, and when this is empty with allMcpTemplates false, only its managers may.

permission
enum<string>
required

What the key may do at the provider, as declared by its managers.

Available options:
read,
read_write,
not_declared
addedAt
string
required

ISO 8601 timestamp.

addedBy
string
required

User id.

updatedAt
string
required

ISO 8601 timestamp.

updatedBy
string
required

User id.

description
string
allAgents
boolean

True means every agent in the workspace may use the secret.

agentIds
string[]

Agents granted use, in addition to the teams in groupIds.

adminUserIds
string[]

Empty or absent means every member may administer it.

groupIds
string[]

Teams whose agents are granted use.

disabled
boolean
meta
object
{key}
any