> ## Documentation Index > Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Integration > Return a single integration row or 404. ## OpenAPI ````yaml /standalone/openapi.json get /admin/api/v1/integrations/{integration_id} openapi: 3.1.0 info: title: Idun Agent Engine Server description: A production-ready server for conversational AI agents version: 0.6.1 servers: [] security: [] tags: - name: Runtime description: >- Public agent run endpoints, engine operations, and chat-channel webhooks. SSE streaming via the AG-UI protocol. - name: Agent Configuration description: >- Singleton admin endpoints for the agent, prompts, memory, guardrails, and onboarding wizard. - name: Auth & SSO description: >- Login, sessions, password change, SSO config, and the public SSO discovery endpoint. - name: Integrations & Tools description: MCP server registry and external integration credentials. - name: Observability description: Tracing/logging provider configuration. - name: Traces description: >- Trace and span storage admin endpoints — list, detail, delete, and pipeline-health for the standalone trace store. - name: Dashboard description: >- Operator dashboard widgets — KPIs, time-series, top errors, and configuration summary. paths: /admin/api/v1/integrations/{integration_id}: get: tags: - Integrations & Tools summary: Get Integration description: Return a single integration row or 404. operationId: get_integration_admin_api_v1_integrations__integration_id__get parameters: - name: integration_id in: path required: true schema: type: string format: uuid title: Integration Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StandaloneIntegrationRead' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: StandaloneIntegrationRead: properties: id: type: string format: uuid title: Id slug: type: string title: Slug name: type: string title: Name enabled: type: boolean title: Enabled integration: $ref: '#/components/schemas/IntegrationConfig' createdAt: type: string format: date-time title: Createdat updatedAt: type: string format: date-time title: Updatedat type: object required: - id - slug - name - enabled - integration - createdAt - updatedAt title: StandaloneIntegrationRead description: GET response and the data payload of POST/PATCH/DELETE responses. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError IntegrationConfig: properties: provider: $ref: '#/components/schemas/IntegrationProvider' description: The messaging provider type. enabled: type: boolean title: Enabled description: Toggle this integration on or off. default: true config: anyOf: - $ref: '#/components/schemas/WhatsAppIntegrationConfig' - $ref: '#/components/schemas/DiscordIntegrationConfig' - $ref: '#/components/schemas/SlackIntegrationConfig' - $ref: '#/components/schemas/GoogleChatIntegrationConfig' - $ref: '#/components/schemas/TeamsIntegrationConfig' title: Config description: Provider-specific configuration. type: object required: - provider - config title: IntegrationConfig description: |- Top-level integration configuration. Each integration binds an external messaging provider to the agent. When the engine starts, it registers webhook endpoints for each enabled integration. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError IntegrationProvider: type: string enum: - WHATSAPP - DISCORD - SLACK - GOOGLE_CHAT - TEAMS title: IntegrationProvider description: Supported integration providers. WhatsAppIntegrationConfig: properties: accessToken: type: string title: Accesstoken description: Meta Graph API permanent access token. phoneNumberId: type: string title: Phonenumberid description: WhatsApp Business phone number ID. verifyToken: type: string title: Verifytoken description: >- Webhook verification token. Must match the token configured in the Meta App Dashboard webhook settings. apiVersion: type: string title: Apiversion description: Meta Graph API version. default: v21.0 type: object required: - accessToken - phoneNumberId - verifyToken title: WhatsAppIntegrationConfig description: |- WhatsApp Business Cloud API configuration. Requires a Meta Business account with a WhatsApp Business API setup. The ``verify_token`` is used by Meta to validate the webhook endpoint during initial registration. DiscordIntegrationConfig: properties: botToken: type: string title: Bottoken description: Discord bot token (used for REST API calls). applicationId: type: string title: Applicationid description: Discord application ID. publicKey: type: string title: Publickey description: >- Ed25519 public key from the Discord application settings. Used to verify interaction webhook signatures. guildId: anyOf: - type: string - type: 'null' title: Guildid description: Optional guild (server) ID to restrict the integration to. type: object required: - botToken - applicationId - publicKey title: DiscordIntegrationConfig description: |- Discord bot configuration for the Interactions Endpoint webhook. Requires a Discord application with a bot user created at https://discord.com/developers/applications. The ``public_key`` is used to verify Ed25519 signatures on incoming interaction payloads. SlackIntegrationConfig: properties: botToken: type: string title: Bottoken description: Slack bot token (xoxb-...). signingSecret: type: string title: Signingsecret description: Signing secret for verifying webhook requests. type: object required: - botToken - signingSecret title: SlackIntegrationConfig description: |- Slack Events API configuration. Requires a Slack app with a bot token and signing secret. The ``signing_secret`` is used to verify incoming webhook requests via HMAC-SHA256. GoogleChatIntegrationConfig: properties: serviceAccountCredentialsJson: type: string title: Serviceaccountcredentialsjson description: Service account credentials JSON for calling the Chat API. projectNumber: type: string title: Projectnumber description: GCP project number used to verify inbound JWT tokens. localMode: type: boolean title: Localmode description: >- When enabled, rewrites the webhook URL from http to https for JWT audience verification. Use this when developing behind a TLS-terminating proxy like ngrok. default: false type: object required: - serviceAccountCredentialsJson - projectNumber title: GoogleChatIntegrationConfig description: |- Google Chat app configuration. Requires a GCP project with the Google Chat API enabled, a service account for sending messages, and the project number for verifying inbound JWT bearer tokens. TeamsIntegrationConfig: properties: appId: type: string title: Appid description: Microsoft App ID from the Azure AD app registration. appPassword: type: string title: Apppassword description: Client secret from the Azure AD app registration. appTenantId: type: string title: Apptenantid description: Azure AD tenant ID that owns the app registration. type: object required: - appId - appPassword - appTenantId title: TeamsIntegrationConfig description: >- Microsoft Teams integration configuration. Single-tenant only: each customer registers their own Microsoft app in their own Azure AD and runs their own engine instance against it. Authentication uses Bot Framework's ``ConfigurationBotFrameworkAuthentication`` with ``MicrosoftAppType=SingleTenant`` hardcoded. ````