FIfiles
partners
Partners

Update Partner

Changed on

Update Partner

patch/partners/{id}

Request

  • Base URL
    https://app.files.com/api/rest/v1
  • URL
    https://app.files.com/api/rest/v1/partners/{id}
  • Auth
    none declared

Path parameters

idinteger required

Partner ID.

Request body multipart/form-data

ai_assistant_personality_idinteger

AI Assistant Personality ID assigned to this Partner, if any. Users in the Partner inherit it unless a direct per-user assignment overrides it.

allowed_ipsstring

A list of allowed IPs for this Partner. Newline delimited. Partner User IP access is allowed when the IP matches the Partner, User, or Site allowed IP lists.

allow_bypassing_2fa_policiesboolean

Allow Partner Admins to change Two-Factor Authentication requirements for Partner Users.

allow_credential_changesboolean

Allow Partner Admins to change or reset credentials for users belonging to this Partner.

allow_providing_gpg_keysboolean

Allow Partner Admins to provide GPG keys.

allow_user_creationboolean

Allow Partner Admins to create users.

cc_emails_to_responsible_partyboolean

When true, emails sent to Partner users are copied to the responsible User or Group.

notesstring

Notes about this Partner.

partner_channel_template_idinteger

ID of the Partner Channel Template assigned to this Partner.

responsible_group_idinteger

ID of the Group responsible for this Partner.

responsible_user_idinteger

ID of the User responsible for this Partner.

show_partner_channel_home_pageboolean

Show Partner users a simplified home page built from this Partner's Channels.

tagsstring

Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags. Tags must only contain lowercase letters, numbers, and hyphens.

namestring

The name of the Partner.

partnership_role'host' | 'guest' | 'host_and_guest'

This site's role for this Partner in Connected Sites relationships. host is a Partner this site configured. guest is a Partner created by approving another site's connection request; it has no root folder and cannot hold users, permissions, or Partner Channels, or host a connection. host_and_guest is a configured Partner that is also the guest side of a connection. Promote a guest Partner by setting this to host_and_guest together with a root_folder.

root_folderstring

The root folder path for this Partner.

Example request

{
  "ai_assistant_personality_id": 1,
  "allowed_ips": "10.0.0.0/8\n127.0.0.1",
  "notes": "This is a note about the partner.",
  "partner_channel_template_id": 1,
  "responsible_group_id": 1,
  "responsible_user_id": 1,
  "tags": "example",
  "name": "Acme Corp",
  "partnership_role": "host",
  "root_folder": "/AcmeCorp"
}

Response

The Partners object.

allow_bypassing_2fa_policiesboolean

Allow Partner Admins to change Two-Factor Authentication requirements for Partner Users.

allowed_ipsstring

A list of allowed IPs for this Partner. Newline delimited. Partner User IP access is allowed when the IP matches the Partner, User, or Site allowed IP lists.

allow_credential_changesboolean

Allow Partner Admins to change or reset credentials for users belonging to this Partner.

allow_providing_gpg_keysboolean

Allow Partner Admins to provide GPG keys.

allow_user_creationboolean

Allow Partner Admins to create users.

cc_emails_to_responsible_partyboolean

When true, emails sent to Partner users are copied to the responsible User or Group.

idinteger

The unique ID of the Partner.

ai_assistant_personality_idinteger

AI Assistant Personality ID assigned to this Partner, if any. Users in the Partner inherit it unless a direct per-user assignment overrides it.

workspace_idinteger

ID of the Workspace associated with this Partner.

namestring

The name of the Partner.

notesstring

Notes about this Partner.

partner_admin_idsinteger[]

Array of User IDs that are Partner Admins for this Partner.

partner_channel_template_idinteger

ID of the Partner Channel Template assigned to this Partner.

partnership_role'host' | 'guest' | 'host_and_guest'

This site's role for this Partner in Connected Sites relationships. host is a Partner this site configured. guest is a Partner created by approving another site's connection request; it has no root folder and cannot hold users, permissions, or Partner Channels, or host a connection. host_and_guest is a configured Partner that is also the guest side of a connection. Promote a guest Partner by setting this to host_and_guest together with a root_folder.

responsible_group_idinteger

ID of the Group responsible for this Partner.

responsible_user_idinteger

ID of the User responsible for this Partner.

root_folderstring

The root folder path for this Partner.

show_partner_channel_home_pageboolean

Show Partner users a simplified home page built from this Partner's Channels.

tagsstring

Comma-separated list of Tags for this Partner. Tags are used for other features, such as UserLifecycleRules, which can target specific tags. Tags must only contain lowercase letters, numbers, and hyphens.

user_idsinteger[]

Array of User IDs that belong to this Partner.

Example response

{
  "allowed_ips": "10.0.0.0/8\n127.0.0.1",
  "connections": [
    {
      "id": 1,
      "role": "guest",
      "site_id": 2,
      "site_name": "Acme Site",
      "mount_path": "_/Sites/2"
    }
  ],
  "id": 1,
  "ai_assistant_personality_id": 1,
  "workspace_id": 1,
  "name": "Acme Corp",
  "notes": "This is a note about the partner.",
  "partner_admin_ids": [
    1,
    2,
    3
  ],
  "partner_channel_template_id": 1,
  "partnership_role": "host",
  "responsible_group_id": 1,
  "responsible_user_id": 1,
  "root_folder": "/AcmeCorp",
  "tags": "example",
  "user_ids": [
    1,
    2,
    3
  ]
}

Changes