Update a project member's role

PATCH /api/v1/projects/{id}/members/{userId}

Bearer auth

Changes the project role for an active member identified by hex user _id.

Path parameters

id string Required

Project ID (hex ObjectID)
userId string Required

User ID (hex ObjectID)

application/json

Body Required

New role

role string Required

New project-level role

Responses

406

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.
Hide response attributes Show response attributes object
- badRequestDetail object
  
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.
  
  Hide badRequestDetail attribute Show badRequestDetail attribute object
  
  fields array[object]
  
  Fields with validation failures.
  
  Hide fields attributes Show fields attributes object
  
  A field and its validation failure.
  
  description string Required
  
  Human-readable validation failure.
  
  field string Required
  
  Name or path of the invalid request field.
- detail string Required
  
  Human-readable error details.
- error integer Required
  
  HTTP status code.
- errorCode string Required
  
  Machine-readable error code.
- parameters array[string]
  
  Request parameter names associated with the error; omitted when none apply.
- reason string Required
  
  HTTP status reason phrase.
Hide response attributes Show response attributes object
- badRequestDetail object
  
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.
  
  Hide badRequestDetail attribute Show badRequestDetail attribute object
  
  fields array[object]
  
  Fields with validation failures.
  
  Hide fields attributes Show fields attributes object
  
  A field and its validation failure.
  
  description string Required
  
  Human-readable validation failure.
  
  field string Required
  
  Name or path of the invalid request field.
- detail string Required
  
  Human-readable error details.
- error integer Required
  
  HTTP status code.
- errorCode string Required
  
  Machine-readable error code.
- parameters array[string]
  
  Request parameter names associated with the error; omitted when none apply.
- reason string Required
  
  HTTP status reason phrase.
200

application/vnd.agent-engine-2026-09-20-preview+json

application/vnd.agent-engine-2026-09-20-preview+json application/json

OK
Hide response attributes Show response attributes object
- created_at string
- email string
  
  Resolved for display only.
- name string
  
  Display name; empty when the user record has none.
- org_id string
  
  The project's parent org (hex).
- roles array[object]
  
  Effective project roles (direct + inherited).
  
  Hide roles attributes Show roles attributes object
  
  org_id string
  
  project_id string
  
  role string
- updated_at string
- user_id string
  
  Stable user _id (hex).
Hide response attributes Show response attributes object
- created_at string
- email string
  
  Resolved for display only.
- name string
  
  Display name; empty when the user record has none.
- org_id string
  
  The project's parent org (hex).
- roles array[object]
  
  Effective project roles (direct + inherited).
  
  Hide roles attributes Show roles attributes object
  
  org_id string
  
  project_id string
  
  role string
- updated_at string
- user_id string
  
  Stable user _id (hex).
400

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Bad Request
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
404

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Not Found
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
500

application/json

application/json application/vnd.agent-engine-2026-09-20-preview+json

Internal Server Error
Hide response attributes Show response attributes object
- code string
- error string
- success boolean
Hide response attributes Show response attributes object
- code string
- error string
- success boolean

PATCH /api/v1/projects/{id}/members/{userId}

curl \
 --request PATCH 'https://agentengine.mongodb.com/api/v1/projects/{id}/members/{userId}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "role": "string"
}'

Request examples

{
  "role": "string"
}

Response examples (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Response examples (406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

Response examples (200)

{
  "created_at": "string",
  "email": "string",
  "name": "string",
  "org_id": "string",
  "roles": [
    {
      "org_id": "string",
      "project_id": "string",
      "role": "string"
    }
  ],
  "updated_at": "string",
  "user_id": "string"
}

Response examples (200)

{
  "created_at": "string",
  "email": "string",
  "name": "string",
  "org_id": "string",
  "roles": [
    {
      "org_id": "string",
      "project_id": "string",
      "role": "string"
    }
  ],
  "updated_at": "string",
  "user_id": "string"
}

Response examples (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (404)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (500)

{
  "code": "string",
  "error": "string",
  "success": true
}

Response examples (500)

{
  "code": "string",
  "error": "string",
  "success": true
}