---
title: "Update a mailbox access"
method: PATCH
path: "/1/accounts/{account}/invitations/{invitation}/mailbox/{mail_id}"
tags: ["User Management > Accounts > Invitations > Mailbox"]
---

# Update a mailbox access

`PATCH /1/accounts/{account}/invitations/{invitation}/mailbox/{mail_id}`

This API endpoint allows you to update an email access, for an invitation of a user in an account.

## Path parameters

- `account` integer, required
- `invitation` integer, required
- `mail_id` string, required

## Request body

- object
  - `mailbox_name` string, required
  - `mailbox_permissions` object, required
    - `can_access_logs` boolean, required
    - `can_change_password` boolean, required
    - `can_configure_mail_folders` boolean, required
    - `can_manage_aliases` boolean, required
    - `can_manage_auto_reply` boolean, required
    - `can_manage_filters` boolean, required
    - `can_manage_redirections` boolean, required
    - `can_manage_security` boolean, required
    - `can_manage_signatures` boolean, required
    - `can_send_emails` boolean

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 087adaadAccountInvitation
    - `id` integer, required — Unique identifier of the resource `AccountInvitation`
    - `first_name` string, required — First name
    - `last_name` string, required — Last name
    - `email` string, required — Email
    - `strict` boolean, required
    - `status` 'accepted' | 'cancelled' | 'pending' | 'rejected', required — Status of the resource `AccountInvitation`
    - `role_type` 'admin' | 'normal' | 'owner', required
    - `teams` 087adaadTeam[]
      - `id` integer, required — Unique identifier of the resource `Team`
      - `name` string, required — Name of the resource `Team`
      - `color_id` integer, required — Unique identifier of the `color` of the resource `Team`
      - `created_at` integer, required — Timestamp `Team` has been created
      - `updated_at` integer, required — Timestamp `Team` has been updated
      - `user_count` integer — User count related to the resource `Team`
    - `language_id` integer, required — Unique identifier of the `language` that is related to the resource `AccountInvitation`
    - `locale` string, required — Represents a language identifier and a region identifier
    - `account_id` integer, required — Unique identifier of the `account` that is related to the resource `AccountInvitation`
    - `has_ksuite` boolean, required
    - `has_billing` boolean, required
    - `has_billing_mailing` boolean, required
    - `has_mailing` boolean, required
    - `ksuite` unknown[], nullable
      - unknown
    - `app_accesses` string, nullable
    - `permissions` unknown[]
      - unknown
    - `service_permissions` unknown[]
      - unknown
    - `sent_at` integer, nullable, required
    - `created_at` integer, required — Timestamp `AccountInvitation` has been created
    - `updated_at` integer, required — Timestamp `AccountInvitation` has been updated
    - `expired_at` integer, nullable, required — Timestamp `AccountInvitation` has expired
    - `url_accept` string, required
    - `qr_code` string

## Other responses

- `404` — Not Found

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)
