Update a group

Update a group

put

Update an existing group

Authorizations

bearerAuth

AuthorizationstringRequired

Use Common JWT

Path parameters

groupIdstringRequired

Group id

Example: 60af77fd294165466ccdf510

Header parameters

X-Symphony-Hoststring · min: 1Required

headers to indentify the originator

Example: localhost.symphony.com

If-MatchstringRequired

ETag of group to be updated

Example: e3a52e72-0854-4401-8c24-e0b17c0ca304

Body

application/json

A reduced set Group object, for retrieving list of group purpose

typestring · min: 1Required

Group type identifier

Example: SDL

ownerTypestring · enumRequired

Owner type. Ony TENANT supported now

Example: TENANTPossible values:

ownerIdinteger · int64Required

Owner id if the owner type is tenant (podId) or user (userId), otherwise null

Example: 100

namestring · min: 1Required

Group's name

Example: Test Group

subTypestring · enumOptional

The type of the company new groupType

Example: COMMUNITYPossible values:

referrerstringOptional

Symphony, referring company name, referring channel partner name

idstring · min: 1Optional

Group's unique identifier

Example: 60af77fd294165466ccdf510

statusstring · enumOptional

Status flag to distinguish between active and deleted objects

Example: ACTIVEPossible values:

eTagstring · min: 1OptionalExample: e3a52e72-0854-4401-8c24-e0b17c0ca304

Responses

200

Successful response. Returns the group just updated

application/json

400

Returned if missing required parameters or wrong parameters

application/json

401

Returned if wrong or missing JWT token

application/json

403

Returned if JWT token missing the required entitlement

application/json

404

Returned if groupId is not found

application/json

412

The update is rejected because concurrent update

application/json

429

Returned if the backend is overloaded

application/json

452

Returned if there is a violation in info barrier rules. This error is not relevant in case of a Company group

application/json

put

/v1/groups/{groupId}

HTTPcURLJavaScriptPython

PUT /profile-manager/v1/groups/{groupId} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
X-Symphony-Host: localhost.symphony.com
If-Match: e3a52e72-0854-4401-8c24-e0b17c0ca304
Content-Type: application/json
Accept: */*
Content-Length: 924

{
  "type": "SDL",
  "ownerType": "TENANT",
  "ownerId": 100,
  "name": "Test Group",
  "subType": "COMMUNITY",
  "referrer": "text",
  "members": [],
  "profile": {
    "displayName": "Test Group",
    "companyName": "Acme Corporation",
    "email": "[email protected]",
    "mobile": "[phone]",
    "jobTitle": "text",
    "jobRole": "Director",
    "jobDepartment": "text",
    "jobDivision": "text",
    "jobPhone": "text",
    "jobCity": "text",
    "industryOfInterest": [
      "Services"
    ],
    "assetClassesOfInterest": [
      "Equities"
    ],
    "marketCoverage": [
      "EMEA"
    ],
    "responsibility": [
      "Escalation"
    ],
    "function": [
      "Collateral"
    ],
    "instrument": [
      "Equities"
    ]
  },
  "visibilityRestriction": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  },
  "implicitConnection": {
    "connectedTenantsList": [
      100
    ],
    "connectedUsersList": [
      12345678900000
    ]
  },
  "interactionTransfer": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  },
  "id": "60af77fd294165466ccdf510",
  "status": "ACTIVE",
  "eTag": "e3a52e72-0854-4401-8c24-e0b17c0ca304"
}

{
  "type": "SDL",
  "ownerType": "TENANT",
  "ownerId": 100,
  "name": "Test Group",
  "id": "text",
  "createdDate": "2026-04-02T01:05:49.628Z",
  "createdBy": "text",
  "updatedDate": "2026-04-02T01:05:49.628Z",
  "updatedBy": "text",
  "status": "ACTIVE",
  "eTag": "e3a52e72-0854-4401-8c24-e0b17c0ca304",
  "members": [
    {
      "memberTenant": 100,
      "memberId": 12345678900000
    },
    {
      "addedDate": "2026-04-02T01:05:49.628Z"
    }
  ],
  "profile": {
    "displayName": "Test Group",
    "companyName": "Acme Corporation",
    "email": "[email protected]",
    "mobile": "[phone]",
    "jobTitle": "text",
    "jobRole": "Director",
    "jobDepartment": "text",
    "jobDivision": "text",
    "jobPhone": "text",
    "jobCity": "text",
    "industryOfInterest": [
      "Services"
    ],
    "assetClassesOfInterest": [
      "Equities"
    ],
    "marketCoverage": [
      "EMEA"
    ],
    "responsibility": [
      "Escalation"
    ],
    "function": [
      "Collateral"
    ],
    "instrument": [
      "Equities"
    ],
    "id": "text",
    "avatars": []
  },
  "visibilityRestriction": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  },
  "implicitConnection": {
    "connectedTenantsList": [
      100
    ],
    "connectedUsersList": [
      12345678900000
    ]
  },
  "interactionTransfer": {
    "restrictedTenantsList": [
      100
    ],
    "restrictedUsersList": [
      12345678900000
    ]
  }
}