Skip to main content
GET
Get project integration

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required
Pattern: ^org_[a-z2-7]{26}$
projectID
string
required
Pattern: ^proj_[a-z2-7]{26}$
integrationID
string
required
Pattern: ^itg_[a-z2-7]{26}$

Response

Get project integration.

id
string
required
Pattern: ^itg_[a-z2-7]{26}$
project_id
string
required
Pattern: ^proj_[a-z2-7]{26}$
name
string
required

Immutable, project-unique integration name used in config keys and qualified tool names.

Pattern: ^[a-zA-Z][a-zA-Z0-9-]{0,31}$
integration_kind
enum<string>
required

Registered integration implementation; independent of the saved integration's name and immutable ID.

Available options:
slack_thread,
discord_thread,
github_pr
state
enum<string>
required
Available options:
active,
disconnected
setup_revision
integer
required

Credential and transport revision. Launcher edits leave this value unchanged.

Required range: x >= 1
settings
object
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_agent_display_name
string
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.

Maximum string length: 512
provider_config
object
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.

capabilities
object
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
last_oauth_flow_id
string
Pattern: ^ioaf_[a-z2-7]{26}$
runtime_failure
object

Most recent connection failure for the active integration's current setup and credential version. Returned only by Get integration, not list or mutation responses. Omission does not establish provider connectivity; a runtime lease is not a connection check.

provider_tenant_id
string

Verified provider identity, omitted until first connection. Retained after disconnect.

provider_account_ref
string

Verified provider account, omitted until first connection. Retained after disconnect.

bot_mention
string

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_id
string
Pattern: ^sec_[a-z2-7]{26}$