curl --request PUT \
--url https://hiimpria.ai/api/admin/boards/access \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"personal": true,
"shared": true,
"userInstitutionId": "<string>",
"userId": "<string>",
"institutionId": "<string>"
}
'import requests
url = "https://hiimpria.ai/api/admin/boards/access"
payload = {
"personal": True,
"shared": True,
"userInstitutionId": "<string>",
"userId": "<string>",
"institutionId": "<string>"
}
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
personal: true,
shared: true,
userInstitutionId: '<string>',
userId: '<string>',
institutionId: '<string>'
})
};
fetch('https://hiimpria.ai/api/admin/boards/access', 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://hiimpria.ai/api/admin/boards/access",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'personal' => true,
'shared' => true,
'userInstitutionId' => '<string>',
'userId' => '<string>',
'institutionId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hiimpria.ai/api/admin/boards/access"
payload := strings.NewReader("{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-access-token", "<api-key>")
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.put("https://hiimpria.ai/api/admin/boards/access")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hiimpria.ai/api/admin/boards/access")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"userInstitutionId": "<string>",
"personal": true,
"shared": true
}Grant or revoke Projects boards access on one membership
Sets the two Projects boards entitlements (boards.personal, boards.shared) on ONE user–institution membership row. Allowed to an administrator of that institution (institutions.edit) or a manager of the institution’s account. The row must exist and be active (enrol the person first); only the two entitlement strings are written, nothing else on the row changes. A Praxis staff account’s rights cannot be changed here (403). Design: docs/plans/2026-10-06-boards-account-entitlements-design.md (D6).
curl --request PUT \
--url https://hiimpria.ai/api/admin/boards/access \
--header 'Content-Type: application/json' \
--header 'x-access-token: <api-key>' \
--data '
{
"personal": true,
"shared": true,
"userInstitutionId": "<string>",
"userId": "<string>",
"institutionId": "<string>"
}
'import requests
url = "https://hiimpria.ai/api/admin/boards/access"
payload = {
"personal": True,
"shared": True,
"userInstitutionId": "<string>",
"userId": "<string>",
"institutionId": "<string>"
}
headers = {
"x-access-token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-access-token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
personal: true,
shared: true,
userInstitutionId: '<string>',
userId: '<string>',
institutionId: '<string>'
})
};
fetch('https://hiimpria.ai/api/admin/boards/access', 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://hiimpria.ai/api/admin/boards/access",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'personal' => true,
'shared' => true,
'userInstitutionId' => '<string>',
'userId' => '<string>',
'institutionId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-access-token: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hiimpria.ai/api/admin/boards/access"
payload := strings.NewReader("{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-access-token", "<api-key>")
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.put("https://hiimpria.ai/api/admin/boards/access")
.header("x-access-token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hiimpria.ai/api/admin/boards/access")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-access-token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"personal\": true,\n \"shared\": true,\n \"userInstitutionId\": \"<string>\",\n \"userId\": \"<string>\",\n \"institutionId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"userInstitutionId": "<string>",
"personal": true,
"shared": true
}Authorizations
JWT token passed in x-access-token header
Body
Grant (true) or revoke (false) the personal Projects workspace.
Grant (true) or revoke (false) the institution's shared Projects workspace.
The membership row id. Either this, or userId + institutionId.
Was this page helpful?