project_idstring required
namestring required
Immutable, project-unique integration name used in config keys and qualified tool names.
integration_kind'slack_thread' | 'discord_thread' | 'github_pr' required
Registered integration implementation; independent of the saved integration's name and immutable ID.
state'active' | 'disconnected' required
setup_revisioninteger required
Credential and transport revision. Launcher edits leave this value unchanged.
settingsIntegrationSettings required
Integration-owned settings JSON. Validate against capabilities.settings.input_schema from the integration catalog. Public profile references use aprf_ IDs and resolve at runtime.
provider_tenant_idstring
Verified provider identity, omitted until first connection. Retained after disconnect.
provider_account_refstring
Verified provider account, omitted until first connection. Retained after disconnect.
provider_agent_display_namestring required
Provider account display label, at most 512 UTF-8 bytes. Leading and trailing whitespace is trimmed on save. Empty means no label; an omitted or empty value clears the label on account-management updates.
bot_mentionstring
GitHub App mention including the leading @, derived from the verified App slug. Omitted when the verified slug is unavailable or the integration is not GitHub. Retained after disconnect.
credential_secret_idstring
provider_configIntegrationProviderConfig required
Non-secret provider configuration, validated for the selected provider. Slack and GitHub integrations require an empty object. Discord accepts only public_key (optional, a 32-byte hex-encoded Ed25519 verification key for interaction callbacks). Omnara manages one Gateway connection per Discord integration. Credentials and integration behavior are not accepted here.
created_atstring date-time required
updated_atstring date-time required