workspace-connectors

Create Workspace Connector

Provision a connector using the Resource Foundation.

Requires a plan with the connectors feature (XL, #1551); existing connectors on lower plans keep working. The max_connectors seat cap applies second, inside ConnectorProvisioningService.

post/api/v1/workspace-connectors

Request

  • Base URL: https://memory.kagura-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://memory.kagura-ai.com/api/v1/workspace-connectors
  • Auth: none declared

Headers

authorizationstring nullable

Request body

connector_type'slack' | 'discord' | 'teams' required

Connector backend to provision

resource_idstring required

Workspace-scoped resource slug for ingested chat events

display_namestring nullable
oauth_tokensobject nullable

OAuth token bundle; stored Fernet-encrypted

pii_guardrail_configobject nullable

PII guardrail config for ai-worker pre-compile

litellm_virtual_key_idstring nullable
virtual_key_valid_untilstring date-time nullable
quota_events_per_hourinteger
context_idstring uuid nullable

Existing write-target context

auto_create_context_namestring nullable

Create a fresh private context with this name

llm_configobject nullable

BYO LLM bundle; Fernet-encrypted

localestring nullable

Worker pre-compile locale. Must map to the worker Locale contract ('en' | 'ja'); common BCP-47 forms are normalized (ja-JP → ja). See models.worker_runtime.WORKER_LOCALES (#1377).

external_team_idstring nullable

Platform team id (worker dispatch key)

app_keystring

Stable platform app identity selector

slack_install_handlestring nullable

One-time handle from the Slack OAuth callback; resolved server-side to oauth_tokens + external_team_id (bot token never sent by client)

Response

Successful Response

connector_idstring uuid required
connector_typestring required
app_keystring required
resource_idstring required
context_idstring uuid nullable
token_idstring required

Public id of the connector's resource token (rtok_ + 22 base62 characters)

tokenstring required

Plaintext resource token; save immediately

kmc_api_keystring nullable

Plaintext KMC write key; shown once (registration flow only)

quota_events_per_hourinteger required
idempotency_key_prefixstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.