Agent: Organisation Settings¶

Get organisation settings¶

GET /api/v1/agent/org-settings/

Requires org_settings: view.

Authentication: API key — Authorization: Bearer <key>

curlPythonJavaScript

curl -sS -X GET "https://www-dev.yoshuko.com/api/v1/agent/org-settings/" \
  -H "Authorization: Bearer $YOSHUKO_API_KEY"

import os
import requests

url = f"https://www-dev.yoshuko.com/api/v1/agent/org-settings/"
response = requests.get(url, headers={"Authorization": f"Bearer {os.environ['YOSHUKO_API_KEY']}"}, timeout=30)
response.raise_for_status()
print(response.json() if response.content else response.status_code)

const response = await fetch(`https://www-dev.yoshuko.com/api/v1/agent/org-settings/`, {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.YOSHUKO_API_KEY}` }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(response.status === 204 ? response.status : await response.json());

Status	Meaning
`200`	No response body
`401`	Missing, unknown, revoked or expired key; or the organisation's plan is inactive (`subscription_inactive`) or unverified (`org_unverified`).
`403`	The key's scope for this resource does not allow the action.
`429`	Rate limited (300 requests/hour per key). Retry after the `Retry-After` header.

Update organisation settings¶

PATCH /api/v1/agent/org-settings/

Requires org_settings: edit. Only the fields in the response are writable; anything else is ignored.

Authentication: API key — Authorization: Bearer <key>

curlPythonJavaScript

curl -sS -X PATCH "https://www-dev.yoshuko.com/api/v1/agent/org-settings/" \
  -H "Authorization: Bearer $YOSHUKO_API_KEY"

import os
import requests

url = f"https://www-dev.yoshuko.com/api/v1/agent/org-settings/"
response = requests.patch(url, headers={"Authorization": f"Bearer {os.environ['YOSHUKO_API_KEY']}"}, timeout=30)
response.raise_for_status()
print(response.json() if response.content else response.status_code)

const response = await fetch(`https://www-dev.yoshuko.com/api/v1/agent/org-settings/`, {
  method: "PATCH",
  headers: { Authorization: `Bearer ${process.env.YOSHUKO_API_KEY}` }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(response.status === 204 ? response.status : await response.json());

Status	Meaning
`200`	No response body
`400`	No response body
`401`	Missing, unknown, revoked or expired key; or the organisation's plan is inactive (`subscription_inactive`) or unverified (`org_unverified`).
`403`	The key's scope for this resource does not allow the action.
`429`	Rate limited (300 requests/hour per key). Retry after the `Retry-After` header.