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": [
123
]
}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": [
123
]
}The counterpart of List Permission Recipients for the secrets and live-connection axis, with the same contract: active and pending Members (Owners and Admins excluded), ids by default, full objects with
expand[], and picker semantics. Passing a resource excludes whoever holds a direct grant on that exact resource. Access received through a group does not exclude them.
Query parameters
| Parameter | Type | Description |
|---|---|---|
secret | UUID | Recipients who do not already hold a direct grant on this secret. |
live_connection | UUID | Recipients who do not already hold a direct 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. See Expanding Responses. |
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": [42]
}
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?