List object permission recipients
curl --request GET \
--url https://api.nekt.ai/api/v1/organization/object-permission-recipients/ \
--header 'x-api-key: <api-key>'import requests
url = "https://api.nekt.ai/api/v1/organization/object-permission-recipients/"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.nekt.ai/api/v1/organization/object-permission-recipients/', 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://api.nekt.ai/api/v1/organization/object-permission-recipients/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nekt.ai/api/v1/organization/object-permission-recipients/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nekt.ai/api/v1/organization/object-permission-recipients/")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nekt.ai/api/v1/organization/object-permission-recipients/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"groups": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"users": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}Secrets & live connections
List Object Permission Recipients
The users and groups that can receive a secret or live connection grant.
GET
/
api
/
v1
/
organization
/
object-permission-recipients
/
List object permission recipients
curl --request GET \
--url https://api.nekt.ai/api/v1/organization/object-permission-recipients/ \
--header 'x-api-key: <api-key>'import requests
url = "https://api.nekt.ai/api/v1/organization/object-permission-recipients/"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.nekt.ai/api/v1/organization/object-permission-recipients/', 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://api.nekt.ai/api/v1/organization/object-permission-recipients/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.nekt.ai/api/v1/organization/object-permission-recipients/"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.nekt.ai/api/v1/organization/object-permission-recipients/")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nekt.ai/api/v1/organization/object-permission-recipients/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"groups": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"users": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}The counterpart of List Permission Recipients for the secrets and live-connection axis, with the same contract: active Members only, ids by default, full objects with
expand, and picker semantics — passing a resource excludes whoever already holds a grant there.
Query parameters
| Parameter | Type | Description |
|---|---|---|
secret | UUID | Recipients who do not already hold a grant on this secret. |
live_connection | UUID | Recipients who do not already hold a grant on this live connection. |
search | string | Match users by name, username, or email, and groups by name or description. |
expand | string | users, groups, or both. |
curl --request GET \
--url "https://api.nekt.ai/api/v1/organization/object-permission-recipients/?expand=users" \
--header "x-api-key: YOUR_API_KEY"
{
"groups": ["b8c5e1e3-6d02-4f45-ad20-8f4b6e2d0e13"],
"users": ["3f7c1e88-9a41-4b2d-8e5f-6c0a2d4b9e11"]
}
Authorizations
API Key authentication. Format: 'x-api-key: api_key'
Query Parameters
Only recipients who can still be granted on this live connection.
Match users by name, username or email, and groups by name or description.
Only recipients who can still be granted on this secret.
Was this page helpful?