---
title: "Update an user group membership"
method: PATCH
path: "/user_group_memberships/{id}"
tags: ["UserGroupMembership"]
---

# Update an user group membership

`PATCH /user_group_memberships/{id}`

## Request

- Base URL: `https://r38.coupadev.com/api`
- URL: `https://r38.coupadev.com/api/user_group_memberships/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://r38.coupadev.com/oauth2/authorizations/new`
    - Token URL: `https://r38.coupadev.com/oauth2/token`
  - OAuth 2
    - Client credentials
    - Token URL: `https://r38.coupadev.com/oauth2/access_tokens`
- TypeScript: <https://skmtc.dev/coupa/apis/coupa-api-4/docs/user_group_memberships/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update an user group membership

## Path parameters

- `id` integer, required

## Query parameters

- `return_object` 'limited' | 'shallow' | 'none'
- `filter` string

## Request body

- UserGroupMembership
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `id` integer: Coupa unique identifier
  - `owner` boolean: Indicates whether the user is admin or not
  - `participant` boolean: Indicates whether the user is participant or not
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user-group` UserGroup
    - `active` boolean: Active
    - `avatar-thumb-url` string, string: URL for avatar thumbnail
    - `can-approve` boolean: User group has the ability to be an approver
    - `content-groups` BusinessGroup[]
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `description` string, string(255): description
      - `id` integer: Coupa unique identifier
      - `name` string, string(100), required: name
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `updated-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `description` string, text: Description
    - `id` integer: Coupa unique identifier
    - `mention-name` string, string(255): Mention name
    - `name` string, string(255), required: Name
    - `open` boolean: User group is open for everyone to join or owner must invite others
    - `owner` UserGroup (recursive)
    - `type` string, string(255): Blank for Groups, Project for Projects
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `updated-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `users` UserSimple[]
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user-group-id` integer: User group or Project Id
  - `user-group-type` string, string(255): User group or Project are the valid types
  - `user-id` integer: User Id

## Response `200`

UserGroupMembership object

- UserGroupMembership[]
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `id` integer: Coupa unique identifier
  - `owner` boolean: Indicates whether the user is admin or not
  - `participant` boolean: Indicates whether the user is participant or not
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user-group` UserGroup
    - `active` boolean: Active
    - `avatar-thumb-url` string, string: URL for avatar thumbnail
    - `can-approve` boolean: User group has the ability to be an approver
    - `content-groups` BusinessGroup[]
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `created-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `description` string, string(255): description
      - `id` integer: Coupa unique identifier
      - `name` string, string(100), required: name
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `updated-by` UserSimple
        - `avatar-thumb-url` string, string: Avatar url
        - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
        - `email` string, string(255), required: email
        - `employee-number` string, string(255): employee number
        - `firstname` string, string(40), required: first name
        - `fullname` string, string(255): full name
        - `id` integer: Coupa unique identifier
        - `lastname` string, string(40), required: last name
        - `login` string, string(255), required: login
        - `salesforce-id` string, string(255), required: salesforce_id
        - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `created-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `description` string, text: Description
    - `id` integer: Coupa unique identifier
    - `mention-name` string, string(255): Mention name
    - `name` string, string(255), required: Name
    - `open` boolean: User group is open for everyone to join or owner must invite others
    - `owner` UserGroup (recursive)
    - `type` string, string(255): Blank for Groups, Project for Projects
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `updated-by` UserSimple
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `users` UserSimple[]
      - `avatar-thumb-url` string, string: Avatar url
      - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
      - `email` string, string(255), required: email
      - `employee-number` string, string(255): employee number
      - `firstname` string, string(40), required: first name
      - `fullname` string, string(255): full name
      - `id` integer: Coupa unique identifier
      - `lastname` string, string(40), required: last name
      - `login` string, string(255), required: login
      - `salesforce-id` string, string(255), required: salesforce_id
      - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `user-group-id` integer: User group or Project Id
  - `user-group-type` string, string(255): User group or Project are the valid types
  - `user-id` integer: User Id

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

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