Change the organization's settings (admin)
const url = 'https://example.com/v1/orgs/example/settings';const options = { method: 'PATCH', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"proposal_four_eyes":true,"csaf_namespace":"example","proposals_digest_hour":1,"proposals_digest_time_zone":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://example.com/v1/orgs/example/settings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "proposal_four_eyes": true, "csaf_namespace": "example", "proposals_digest_hour": 1, "proposals_digest_time_zone": "example" }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization (tenant) slug, e.g. alpenrobotik
Request Bodyrequired
Section titled “Request Bodyrequired”object
The manufacturer’s https URL, such as https://example.com, without user info, query or fragment. An empty string clears it.
The local hour the daily proposals digest goes out, in proposals_digest_time_zone
An IANA time zone, such as Europe/Berlin or UTC
Example generated
{ "proposal_four_eyes": true, "csaf_namespace": "example", "proposals_digest_hour": 1, "proposals_digest_time_zone": "example"}Responses
Section titled “Responses”Saved
object
Nobody decides a proposal filed with their own credentials or with an API key they created
The manufacturer’s https URL, the publisher namespace of the organization’s CSAF documents; null until an admin sets it
The local hour the daily proposals digest goes out (6 by default)
The IANA time zone of proposals_digest_hour (UTC by default)
Example generated
{ "proposal_four_eyes": true, "csaf_namespace": "example", "proposals_digest_hour": 1, "proposals_digest_time_zone": "example"}Settings.csafNamespaceInvalid (params.max), settings.digestHourInvalid, settings.timeZoneInvalid, or request.invalidJson
Role below admin
Over the operation’s rate-limit budget (x-affectra-budget): code request.rateLimited with params.budget. Wait Retry-After seconds before trying again.
Every error answer, Content-Type
application/problem+json. The web app and integrations translate code; detail is English,
for people reading curl output or CI logs, and may change wording at
any time. Match on code, never on detail.
object
The HTTP status
Stable error codes. A code is never renamed; new ones may be added, so
a client falls back to detail for a code it doesn’t know. Another
organization’s object answers notFound, the same as a missing one.
What went wrong
Values the code’s message needs, e.g. {“field”: “version”}. Only values the caller sent or may see. Empty when the message needs none.
object
Example
{ "code": "notFound"}Headers
Section titled “Headers”Seconds until a request would be allowed again, at least 1
The server runs without a database or object storage; the catalog is unavailable