Update user invite Run in API Explorer

PATCH /v1/user-invites/{id}

Update a Redpanda Cloud user invite.

Path parameters

  • id string Required
application/json

Body Required

  • update_mask string
  • user_invite object
    Hide user_invite attributes Show user_invite attributes object
    • expires_at string(date-time)
    • role_bindings array[object]
      Hide role_bindings attributes Show role_bindings attributes object
      • role_name string
      • scope object
        Hide scope attributes Show scope attributes object
        • resource_id string
        • resource_type string

          Values are SCOPE_RESOURCE_TYPE_RESOURCE_GROUP, SCOPE_RESOURCE_TYPE_NETWORK, SCOPE_RESOURCE_TYPE_CLUSTER, SCOPE_RESOURCE_TYPE_SERVERLESS_CLUSTER, SCOPE_RESOURCE_TYPE_NETWORK_PEERING, or SCOPE_RESOURCE_TYPE_ORGANIZATION.

Responses

  • 200 application/json

    Ok

    Hide response attribute Show response attribute object
    • user_invite object
      Hide user_invite attributes Show user_invite attributes object
      • created_at string(date-time)
      • email string
      • expires_at string(date-time)
      • id string
      • invite_url string
      • role_bindings array[object]
        Hide role_bindings attributes Show role_bindings attributes object
        • role_name string
        • scope object
          Hide scope attributes Show scope attributes object
          • resource_id string
          • resource_type string

            Values are SCOPE_RESOURCE_TYPE_RESOURCE_GROUP, SCOPE_RESOURCE_TYPE_NETWORK, SCOPE_RESOURCE_TYPE_CLUSTER, SCOPE_RESOURCE_TYPE_SERVERLESS_CLUSTER, SCOPE_RESOURCE_TYPE_NETWORK_PEERING, or SCOPE_RESOURCE_TYPE_ORGANIZATION.

  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • code string(int32)

      RPC status code, as described here.

      Values are OK, CANCELLED, UNKNOWN, INVALID_ARGUMENT, DEADLINE_EXCEEDED, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, UNAUTHENTICATED, RESOURCE_EXHAUSTED, FAILED_PRECONDITION, ABORTED, OUT_OF_RANGE, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, or DATA_LOSS.

    • details array[object]

      A list of messages that carries the error details.

      Details of the error.

      Details of the error.

      One of:
    • message string

      Detailed error message. No compatibility guarantees are given for the text contained in this message.

  • 500 application/json

    Internal Server Error. Reach out to support.

    Hide response attributes Show response attributes object
    • code string(int32)

      RPC status code, as described here.

      Values are OK, CANCELLED, UNKNOWN, INVALID_ARGUMENT, DEADLINE_EXCEEDED, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, UNAUTHENTICATED, RESOURCE_EXHAUSTED, FAILED_PRECONDITION, ABORTED, OUT_OF_RANGE, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, or DATA_LOSS.

    • details array[object]

      A list of messages that carries the error details.

      Details of the error.

      Details of the error.

      One of:
    • message string

      Detailed error message. No compatibility guarantees are given for the text contained in this message.

  • default application/json

    An unexpected error response.

    Hide response attributes Show response attributes object
    • code string(int32)

      RPC status code, as described here.

      Values are OK, CANCELLED, UNKNOWN, INVALID_ARGUMENT, DEADLINE_EXCEEDED, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, UNAUTHENTICATED, RESOURCE_EXHAUSTED, FAILED_PRECONDITION, ABORTED, OUT_OF_RANGE, UNIMPLEMENTED, INTERNAL, UNAVAILABLE, or DATA_LOSS.

    • details array[object]

      A list of messages that carries the error details.

      Details of the error.

      Details of the error.

      One of:
    • message string

      Detailed error message. No compatibility guarantees are given for the text contained in this message.

PATCH /v1/user-invites/{id}
curl \
 --request PATCH 'https://api.redpanda.com/v1/user-invites/{id}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"update_mask":"string","user_invite":{"expires_at":"2025-05-04T09:42:00Z","role_bindings":[{"role_name":"string","scope":{"resource_id":"string","resource_type":"SCOPE_RESOURCE_TYPE_RESOURCE_GROUP"}}]}}'
Request examples
{
  "update_mask": "string",
  "user_invite": {
    "expires_at": "2025-05-04T09:42:00Z",
    "role_bindings": [
      {
        "role_name": "string",
        "scope": {
          "resource_id": "string",
          "resource_type": "SCOPE_RESOURCE_TYPE_RESOURCE_GROUP"
        }
      }
    ]
  }
}
Response examples (200)
{
  "user_invite": {
    "created_at": "2025-05-04T09:42:00Z",
    "email": "string",
    "expires_at": "2025-05-04T09:42:00Z",
    "id": "string",
    "invite_url": "string",
    "role_bindings": [
      {
        "role_name": "string",
        "scope": {
          "resource_id": "string",
          "resource_type": "SCOPE_RESOURCE_TYPE_RESOURCE_GROUP"
        }
      }
    ]
  }
}
Response examples (404)
{
  "code": "OK",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.BadRequest",
      "field_violations": [
        {
          "description": "string",
          "field": "string",
          "localized_message": {
            "locale": "string",
            "message": "string"
          },
          "reason": "string"
        }
      ]
    }
  ],
  "message": "string"
}
Response examples (500)
{
  "code": "OK",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.BadRequest",
      "field_violations": [
        {
          "description": "string",
          "field": "string",
          "localized_message": {
            "locale": "string",
            "message": "string"
          },
          "reason": "string"
        }
      ]
    }
  ],
  "message": "string"
}
Response examples (default)
{
  "code": "OK",
  "details": [
    {
      "@type": "type.googleapis.com/google.rpc.BadRequest",
      "field_violations": [
        {
          "description": "string",
          "field": "string",
          "localized_message": {
            "locale": "string",
            "message": "string"
          },
          "reason": "string"
        }
      ]
    }
  ],
  "message": "string"
}