RemoveSubjectsFromPrincipal

RemoveSubjectsFromPrincipal

nokku.v1.PrincipalService

POST

https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove

path Parameters

workspace_idstring <uuid>required

Example 497f6eca-6276-4993-bfeb-53cbbbba6f08

Authorization

BearerAuth (bearer)
PASETO token authentication. Include the token in the Authorization header: `Authorization: Bearer <token>`
CookieAuth (apiKey in cookie)
Cookie-based authentication (recommended for web applications). The session cookie is automatically sent by browsers after login.

Request Body

required

application/json

object

id?

string <uuid>

subjectIds?

array<string>

type?

string

Enum:"PRINCIPAL_TYPE_UNSPECIFIED""PRINCIPAL_TYPE_USER""PRINCIPAL_TYPE_TEAM""PRINCIPAL_TYPE_SERVICE_ACCOUNT"

Responses

200

Success

application/json

object

Code Samples

curl -X POST 'https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove' \
  -H "Authorization: Bearer <token>" \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}'

const response = await fetch('https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove', {
  method: 'POST',
  headers: {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
},
  body: JSON.stringify({
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}),
});

const data = await response.json();
console.log(data);

import requests

url = 'https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove'
headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
}
payload = {
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

package main

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

func main() {
  body := bytes.NewBuffer([]byte(`{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}`))
  req, err := http.NewRequest("POST", "https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove", body)
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer <token>")
  req.Header.Set("Content-Type", "application/json")

  res, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer res.Body.Close()

  payload, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  fmt.Println(string(payload))
}

using System.Net.Http;
using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove");
request.Headers.Add("Authorization", "Bearer <token>");
request.Content = new StringContent(
    """"{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}"""",
    System.Text.Encoding.UTF8,
    "application/json"
);

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://app.nokku.sh/v1/workspaces/{workspace_id}/principals:remove"))
      .header("Authorization", "Bearer <token>")
      .header("Content-Type", "application/json")
      .method("POST", HttpRequest.BodyPublishers.ofString("""{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "subjectIds": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "type": "PRINCIPAL_TYPE_UNSPECIFIED"
}"""))
      .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

Example Responses