curl --request PUT \
--url https://api.quiva.ai/hub/coworker/profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "<string>",
"trading_names": [
"<string>"
],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": [
"<string>"
],
"never": [
"<string>"
],
"data_handling": "<string>"
}
'import requests
url = "https://api.quiva.ai/hub/coworker/profile"
payload = {
"legal_name": "<string>",
"trading_names": ["<string>"],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": ["<string>"],
"never": ["<string>"],
"data_handling": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legal_name: '<string>',
trading_names: ['<string>'],
what_we_do: '<string>',
industry: '<string>',
regulator: '<string>',
size: '<string>',
locations: '<string>',
financial_year_end: '<string>',
systems_of_record: [{system: 'NetSuite', authoritative_for: 'Supplier and contract data'}],
glossary: [
{
term: 'MSA',
meaning: 'Master services agreement — the umbrella terms a vendor signs before any work order'
}
],
working_hours: '<string>',
timezone: '<string>',
house_style: '<string>',
always: ['<string>'],
never: ['<string>'],
data_handling: '<string>'
})
};
fetch('https://api.quiva.ai/hub/coworker/profile', 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.quiva.ai/hub/coworker/profile",
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([
'legal_name' => '<string>',
'trading_names' => [
'<string>'
],
'what_we_do' => '<string>',
'industry' => '<string>',
'regulator' => '<string>',
'size' => '<string>',
'locations' => '<string>',
'financial_year_end' => '<string>',
'systems_of_record' => [
[
'system' => 'NetSuite',
'authoritative_for' => 'Supplier and contract data'
]
],
'glossary' => [
[
'term' => 'MSA',
'meaning' => 'Master services agreement — the umbrella terms a vendor signs before any work order'
]
],
'working_hours' => '<string>',
'timezone' => '<string>',
'house_style' => '<string>',
'always' => [
'<string>'
],
'never' => [
'<string>'
],
'data_handling' => '<string>'
]),
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.quiva.ai/hub/coworker/profile"
payload := strings.NewReader("{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.quiva.ai/hub/coworker/profile")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.quiva.ai/hub/coworker/profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"legal_name": "<string>",
"trading_names": [
"<string>"
],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": [
"<string>"
],
"never": [
"<string>"
],
"data_handling": "<string>",
"is_default": true
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Set the account's organisation profile
Account admins only — this text lands in every member’s system prompt, plus the judge and verify prompts.
The body is the profile object itself — fields at the top level, never wrapped in a profile key. Sending a body whose fields are all empty drops the layer: the handler then stores an absent profile key rather than {}, so a fresh account is not permanently blocked from its default seed. Every field is optional; empty list entries are dropped rather than stored. Each field has its own rune cap (see the schema), and the whole document is additionally capped at 8000 characters summed across every field. Any cap is enforced at the write and refused by name — never silently truncated.
The write is a read-modify-write over the whole stored document, because agent-service owns the other keys on this subject (voice, expert_count, max_retries, the per-stage model choices). A failed read is therefore a 502, never a write.
A failed role lookup is 502. Subject: microstrate.hub.put.coworker-profile.
curl --request PUT \
--url https://api.quiva.ai/hub/coworker/profile \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"legal_name": "<string>",
"trading_names": [
"<string>"
],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": [
"<string>"
],
"never": [
"<string>"
],
"data_handling": "<string>"
}
'import requests
url = "https://api.quiva.ai/hub/coworker/profile"
payload = {
"legal_name": "<string>",
"trading_names": ["<string>"],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": ["<string>"],
"never": ["<string>"],
"data_handling": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
legal_name: '<string>',
trading_names: ['<string>'],
what_we_do: '<string>',
industry: '<string>',
regulator: '<string>',
size: '<string>',
locations: '<string>',
financial_year_end: '<string>',
systems_of_record: [{system: 'NetSuite', authoritative_for: 'Supplier and contract data'}],
glossary: [
{
term: 'MSA',
meaning: 'Master services agreement — the umbrella terms a vendor signs before any work order'
}
],
working_hours: '<string>',
timezone: '<string>',
house_style: '<string>',
always: ['<string>'],
never: ['<string>'],
data_handling: '<string>'
})
};
fetch('https://api.quiva.ai/hub/coworker/profile', 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.quiva.ai/hub/coworker/profile",
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([
'legal_name' => '<string>',
'trading_names' => [
'<string>'
],
'what_we_do' => '<string>',
'industry' => '<string>',
'regulator' => '<string>',
'size' => '<string>',
'locations' => '<string>',
'financial_year_end' => '<string>',
'systems_of_record' => [
[
'system' => 'NetSuite',
'authoritative_for' => 'Supplier and contract data'
]
],
'glossary' => [
[
'term' => 'MSA',
'meaning' => 'Master services agreement — the umbrella terms a vendor signs before any work order'
]
],
'working_hours' => '<string>',
'timezone' => '<string>',
'house_style' => '<string>',
'always' => [
'<string>'
],
'never' => [
'<string>'
],
'data_handling' => '<string>'
]),
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.quiva.ai/hub/coworker/profile"
payload := strings.NewReader("{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.quiva.ai/hub/coworker/profile")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.quiva.ai/hub/coworker/profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"legal_name\": \"<string>\",\n \"trading_names\": [\n \"<string>\"\n ],\n \"what_we_do\": \"<string>\",\n \"industry\": \"<string>\",\n \"regulator\": \"<string>\",\n \"size\": \"<string>\",\n \"locations\": \"<string>\",\n \"financial_year_end\": \"<string>\",\n \"systems_of_record\": [\n {\n \"system\": \"NetSuite\",\n \"authoritative_for\": \"Supplier and contract data\"\n }\n ],\n \"glossary\": [\n {\n \"term\": \"MSA\",\n \"meaning\": \"Master services agreement — the umbrella terms a vendor signs before any work order\"\n }\n ],\n \"working_hours\": \"<string>\",\n \"timezone\": \"<string>\",\n \"house_style\": \"<string>\",\n \"always\": [\n \"<string>\"\n ],\n \"never\": [\n \"<string>\"\n ],\n \"data_handling\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"legal_name": "<string>",
"trading_names": [
"<string>"
],
"what_we_do": "<string>",
"industry": "<string>",
"regulator": "<string>",
"size": "<string>",
"locations": "<string>",
"financial_year_end": "<string>",
"systems_of_record": [
{
"system": "NetSuite",
"authoritative_for": "Supplier and contract data"
}
],
"glossary": [
{
"term": "MSA",
"meaning": "Master services agreement — the umbrella terms a vendor signs before any work order"
}
],
"working_hours": "<string>",
"timezone": "<string>",
"house_style": "<string>",
"always": [
"<string>"
],
"never": [
"<string>"
],
"data_handling": "<string>",
"is_default": true
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Body
The FROZEN wire shape (docs/abbie-org-profile-and-env-request-plan.md §B-1a). Every field is optional; absent, "" and [] all mean nothing to render — there is no null. Caps are counted in runes and enforced at the write; the whole object is additionally capped at 8000 runes summed across every field.
Response
The organisation profile as stored
The FROZEN wire shape (docs/abbie-org-profile-and-env-request-plan.md §B-1a). Every field is optional; absent, "" and [] all mean nothing to render — there is no null. Caps are counted in runes and enforced at the write; the whole object is additionally capped at 8000 runes summed across every field.