---
title: "Save Connection"
method: PUT
path: "/dashboard/bot/settings/{guild_id}/cross-guild/get-connection/{target_guild}"
tags: ["dashboard"]
---

# Save Connection

`PUT /dashboard/bot/settings/{guild_id}/cross-guild/get-connection/{target_guild}`

## Request

- Base URL: `https://api.monni.fyi` (the document declares no server; this is the origin it was published from)
- URL: `https://api.monni.fyi/dashboard/bot/settings/{guild_id}/cross-guild/get-connection/{target_guild}`
- Auth: HTTP bearer

## Path parameters

- `guild_id` integer, required
- `target_guild` integer, required

## Request body

- GuildConnections
  - `name` string, required
  - `icon` string, nullable, required
  - `guild_id` string, required
  - `given_permissions` GuildConnectionPermissions, required
    - `read_roles` boolean
    - `write_roles` boolean
    - `read_verification` boolean
    - `read_linked_accounts` boolean
    - `share_ban_identity` boolean
    - `write_channels` boolean
    - `share_cases` boolean
    - `apply_moderation_actions` boolean
    - `share_warns` boolean
  - `shared_permissions` GuildConnectionPermissions, required
    - `read_roles` boolean
    - `write_roles` boolean
    - `read_verification` boolean
    - `read_linked_accounts` boolean
    - `share_ban_identity` boolean
    - `write_channels` boolean
    - `share_cases` boolean
    - `apply_moderation_actions` boolean
    - `share_warns` boolean
  - `requested_permissions` object, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-16** `83ac8f547df8`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-09** `0f647fa78ebf`: 6 info
  - added the new optional request property `given_permissions/apply_moderation_actions`
  - added the new optional request property `given_permissions/share_cases`
  - added the new optional request property `given_permissions/share_warns`
  - added the new optional request property `shared_permissions/apply_moderation_actions`
  - …2 more

[Operation history](https://skmtc.dev/monni/apis/monni-api/changes/dashboard/bot/settings/:guild_id/cross-guild/get-connection/:target_guild/put.md)

---

[API](https://skmtc.dev/monni/apis/monni-api.md) - [All operations](https://skmtc.dev/monni/apis/monni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monni/apis/monni-api/revisions/a35aef40d880?raw)