Projects

Modify project user

Changed on Oct 6, 2026

Modifies a user's role in the project.

post/organization/projects/{project_id}/users/{user_id}

Request

Base URL
https://api.openai.com/v1
URL
https://api.openai.com/v1/organization/projects/{project_id}/users/{user_id}
Auth
HTTP bearer

Path parameters

project_idstring required

The ID of the project.

user_idstring required

The ID of the user.

Request body

rolestring nullable

owner or member

Response

Project user's role updated successfully.

object'organization.project.user' required

The object type, which is always organization.project.user

idstring required

The identifier, which can be referenced in API endpoints

namestring nullable

The name of the user

emailstring nullable

The email address of the user

rolestring required

owner or member

added_atinteger required

The Unix timestamp (in seconds) of when the project was added.

Changes

Oct 6, 2026487892d3954e Revision changes
- info
  added the optional property ////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
Oct 5, 20267f654af7f94f Revision changes
- breaking
  added the new path request parameter project_id
- breaking
  added the new path request parameter user_id
- breaking
  removed the enum value member of the request property
- breaking
  removed the enum value owner of the request property
- breaking
  the response property became optional for the status
- breaking
  the response property became optional for the status
- breaking
  response property email list-of-types was widened by adding types null to media type application/json of response 200
- breaking
  response property error/code list-of-types was widened by adding types null to media type application/json of response 400
- breaking
  response property error/param list-of-types was widened by adding types null to media type application/json of response 400
- breaking
  response property name list-of-types was widened by adding types null to media type application/json of response 200
- info
  the endpoint scheme security AdminApiKeyAuth was added to the API
- info
  the request property became optional
- info
  request property list-of-types was widened by adding types null to media type application/json
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property / to the response with the status
- info
  removed the member enum value from the response property for the response status
- info
  removed the owner enum value from the response property for the response status

Operation history