curl --request PATCH \
--url https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"revision": 7,
"consumerPermissions": {
"write": true,
"createThreads": false,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
}
}
'import requests
url = "https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions"
payload = {
"revision": 7,
"consumerPermissions": {
"write": True,
"createThreads": False,
"uploadFiles": True,
"editCanvas": True,
"editThreadRules": False,
"editCoreMemory": False,
"useSharedConnections": True,
"usePersonalConnections": True,
"editWorkspaceRules": False,
"manageAssistants": False,
"manageSkills": False,
"manageAutomations": False,
"manageSharedConnections": False,
"inviteMembers": False
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
revision: 7,
consumerPermissions: {
write: true,
createThreads: false,
uploadFiles: true,
editCanvas: true,
editThreadRules: false,
editCoreMemory: false,
useSharedConnections: true,
usePersonalConnections: true,
editWorkspaceRules: false,
manageAssistants: false,
manageSkills: false,
manageAutomations: false,
manageSharedConnections: false,
inviteMembers: false
}
})
};
fetch('https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions', 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.devic.ai/v1/workspaces/{wid}/consumer-permissions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'revision' => 7,
'consumerPermissions' => [
'write' => true,
'createThreads' => false,
'uploadFiles' => true,
'editCanvas' => true,
'editThreadRules' => false,
'editCoreMemory' => false,
'useSharedConnections' => true,
'usePersonalConnections' => true,
'editWorkspaceRules' => false,
'manageAssistants' => false,
'manageSkills' => false,
'manageAutomations' => false,
'manageSharedConnections' => false,
'inviteMembers' => false
]
]),
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://api.devic.ai/v1/workspaces/{wid}/consumer-permissions"
payload := strings.NewReader("{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"kind": "personal",
"visibility": "<string>",
"archived": true,
"revision": 123,
"members": [
{}
],
"assistants": [
{}
],
"summary": {},
"policyRevision": 123,
"consumerPermissions": {
"write": true,
"createThreads": true,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
},
"capabilities": {
"manageConsumerPermissions": true,
"permissions": {
"write": true,
"createThreads": true,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
}
}
}
}Set consumer permissions
Sets what members with the Consumer account role (and guests from other Devic accounts) can do in a shared workspace. Workspace owner only, acting as a person: an API key without X-Devic-User acts as a manager and is refused with WORKSPACE_OWNER_REQUIRED.
The body is a complete replacement: send all 14 keys. revision is the workspace’s policyRevision; a stale one returns 409 WORKSPACE_REVISION_CONFLICT. Missing or unknown keys return 400 INVALID_CONSUMER_PERMISSIONS. Personal workspaces have no policy.
An action the policy turns off is refused with 403 and { error: "WORKSPACE_CONSUMER_PERMISSION_DENIED", permission: "<key>" }.
curl --request PATCH \
--url https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"revision": 7,
"consumerPermissions": {
"write": true,
"createThreads": false,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
}
}
'import requests
url = "https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions"
payload = {
"revision": 7,
"consumerPermissions": {
"write": True,
"createThreads": False,
"uploadFiles": True,
"editCanvas": True,
"editThreadRules": False,
"editCoreMemory": False,
"useSharedConnections": True,
"usePersonalConnections": True,
"editWorkspaceRules": False,
"manageAssistants": False,
"manageSkills": False,
"manageAutomations": False,
"manageSharedConnections": False,
"inviteMembers": False
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
revision: 7,
consumerPermissions: {
write: true,
createThreads: false,
uploadFiles: true,
editCanvas: true,
editThreadRules: false,
editCoreMemory: false,
useSharedConnections: true,
usePersonalConnections: true,
editWorkspaceRules: false,
manageAssistants: false,
manageSkills: false,
manageAutomations: false,
manageSharedConnections: false,
inviteMembers: false
}
})
};
fetch('https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions', 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.devic.ai/v1/workspaces/{wid}/consumer-permissions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'revision' => 7,
'consumerPermissions' => [
'write' => true,
'createThreads' => false,
'uploadFiles' => true,
'editCanvas' => true,
'editThreadRules' => false,
'editCoreMemory' => false,
'useSharedConnections' => true,
'usePersonalConnections' => true,
'editWorkspaceRules' => false,
'manageAssistants' => false,
'manageSkills' => false,
'manageAutomations' => false,
'manageSharedConnections' => false,
'inviteMembers' => false
]
]),
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://api.devic.ai/v1/workspaces/{wid}/consumer-permissions"
payload := strings.NewReader("{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}")
req, _ := http.NewRequest("PATCH", 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.patch("https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.devic.ai/v1/workspaces/{wid}/consumer-permissions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"revision\": 7,\n \"consumerPermissions\": {\n \"write\": true,\n \"createThreads\": false,\n \"uploadFiles\": true,\n \"editCanvas\": true,\n \"editThreadRules\": false,\n \"editCoreMemory\": false,\n \"useSharedConnections\": true,\n \"usePersonalConnections\": true,\n \"editWorkspaceRules\": false,\n \"manageAssistants\": false,\n \"manageSkills\": false,\n \"manageAutomations\": false,\n \"manageSharedConnections\": false,\n \"inviteMembers\": false\n }\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"kind": "personal",
"visibility": "<string>",
"archived": true,
"revision": 123,
"members": [
{}
],
"assistants": [
{}
],
"summary": {},
"policyRevision": 123,
"consumerPermissions": {
"write": true,
"createThreads": true,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
},
"capabilities": {
"manageConsumerPermissions": true,
"permissions": {
"write": true,
"createThreads": true,
"uploadFiles": true,
"editCanvas": true,
"editThreadRules": false,
"editCoreMemory": false,
"useSharedConnections": true,
"usePersonalConnections": true,
"editWorkspaceRules": false,
"manageAssistants": false,
"manageSkills": false,
"manageAutomations": false,
"manageSharedConnections": false,
"inviteMembers": false
}
}
}
}Authorizations
An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.