Remove embed group members

curl --request DELETE \
  --url https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "members": [
    {
      "embedUserId": 2,
      "externalId": "<string>"
    }
  ]
}
'

import requests

url = "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users"

payload = { "members": [
        {
            "embedUserId": 2,
            "externalId": "<string>"
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({members: [{embedUserId: 2, externalId: '<string>'}]})
};

fetch('https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'members' => [
        [
                'embedUserId' => 2,
                'externalId' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users"

	payload := strings.NewReader("{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

DELETE

api

embed-tenants

{embedTenantName}

groups

{id}

users

Remove embed group members

curl --request DELETE \
  --url https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "members": [
    {
      "embedUserId": 2,
      "externalId": "<string>"
    }
  ]
}
'

import requests

url = "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users"

payload = { "members": [
        {
            "embedUserId": 2,
            "externalId": "<string>"
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({members: [{embedUserId: 2, externalId: '<string>'}]})
};

fetch('https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'members' => [
        [
                'embedUserId' => 2,
                'externalId' => '<string>'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users"

	payload := strings.NewReader("{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{tenant}.cubecloud.dev/api/v1/embed-tenants/{embedTenantName}/groups/{id}/users")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"members\": [\n    {\n      \"embedUserId\": 2,\n      \"externalId\": \"<string>\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

🔒 Admin only. Requires administrator privileges — the authenticated principal (API key, embed JWT, or any bearer token) must belong to a user with the admin role. Removes one or more embed users (1–1000 per request) from a group, identified the same way as when adding them — exactly one of externalId or embedUserId each. Only this group’s membership is dropped; the users themselves and their other groups are left alone, and unlike adding, an unknown externalId is never provisioned. Idempotent: removing a user who is not a member is a no-op. Returns 204 No Content, or 404 if the group does not exist in this tenant.

Authorizations

Authorization

string

header

required

Token authentication. Send Authorization: Bearer <YOUR_TOKEN>.

Path Parameters

embedTenantName

string

required

Name of the embed tenant (the embedTenantName used to generate embed sessions).

integer

required

Numeric id of the group, as returned by the groups endpoints.

Body

application/json

EmbedGroupMembersInput

members

object[]

required

Embed users to add or remove (1–1000 per request).

Required array length: 1 - 1000 elements

Show child attributes

Response

Successful response

Add embed group members List embed users

⌘I

Getting Started

Core Data Endpoints

AI Endpoints

Platform Endpoints

Remove embed group members

Authorizations

Path Parameters

Body

Response