Update project member caps

Restates one member’s caps in full: a source the body does not name loses its cap, and an empty body clears every cap the member holds. The member’s identity is not editable.

Only available on a project with split_policy: none. Under an equal split the division owns those rows, and the request is refused before the body is read. {member_id} is the membership row id, and a member outside the caller’s data access reads as not found.

PUT /api/governance/projects/{project_id}/members/{member_id}

Error

A valid request URL is required to generate request examples

200

{
  "member": {
    "user_id": "<string>",
    "id": "<string>",
    "budget_shares": [
      {
        "source_budget_id": "<string>",
        "id": "<string>",
        "project_id": "<string>",
        "user_id": "<string>",
        "budget_id": "<string>",
        "share_value": 123,
        "share_type": "percent",
        "budget": {
          "max_limit": 1,
          "reset_duration": "1M",
          "id": "<string>",
          "reset_config": {
            "quarter_start_month": 6
          },
          "current_usage": 123,
          "last_reset": "2023-11-07T05:31:56Z",
          "override_amount": 123,
          "override_mode": "<string>",
          "override_cycles_remaining": 123,
          "override_cycles_total": 123,
          "override_anchor_reset": "2023-11-07T05:31:56Z",
          "config_hash": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "rate_limit_shares": [
      {
        "source_rate_limit_id": "<string>",
        "id": "<string>",
        "project_id": "<string>",
        "user_id": "<string>",
        "rate_limit_id": "<string>",
        "token_share": 123,
        "token_share_type": "percent",
        "request_share": 123,
        "request_share_type": "percent",
        "rate_limit": {
          "id": "<string>",
          "token_max_limit": 1,
          "token_reset_duration": "1h",
          "request_max_limit": 1,
          "request_reset_duration": "1h",
          "token_current_usage": 123,
          "token_last_reset": "2023-11-07T05:31:56Z",
          "request_current_usage": 123,
          "request_last_reset": "2023-11-07T05:31:56Z",
          "config_hash": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z"
        },
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "user_name": "<string>",
    "user_email": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

This endpoint is available in Bifrost Enterprise only.

Authorizations

Authorization · string · header · required

Management API authentication for /api/* endpoints. Use the Authorization header with Bearer <API key>. Virtual keys, dashboard/user/session tokens, and x-api-key headers are not supported on management APIs.

Path Parameters

project_id · string · required

member_id · string · required

The membership row id, not the user id.

Body

application/json

The member's complete statement of caps. A source this body does not name loses its cap, and an empty body clears every cap the member holds. Only available on a project with split_policy: none.

budget_shares · object[]

Show child attributes

rate_limit_shares · object[]

Show child attributes

Response

200

application/json

Member updated

member · object

A user on a project's roster. Members are users, never keys or teams: a key authenticates a request, and the user behind it is who belongs to a project.

Show child attributes