Update organization settings
PATCH
/org-admin/{slug}/settings
Partial update of the organization's profile. Only the fields below are writable; others are ignored. String fields accept a string or null and are trimmed. At least one writable field must be present.
logo and banner_image take a URL as-is; to upload an image use POST /org-admin/{slug}/avatar or /banner instead.
Requires permission: org.update_settings
Authorizations
BearerAuth
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Type
HTTP (bearer)
Parameters
Path Parameters
slug*
The organization's slug (not its UUID).
Type
Requiredstring
Example
"local-food-bank-a1b2c3"Pattern
"^[a-z0-9][a-z0-9-]{0,254}$"Request Body
application/json
JSON
{
"legal_name": "string",
"website": "string",
"description": "string",
"country": "string",
"logo": "string",
"banner_image": "string",
"mission": "string",
"contact_email": "string",
"contact_email_public": true,
"founded_year": 0,
"social_links": {
"twitter": "string",
"linkedin": "string",
"facebook": "string",
"instagram": "string",
"youtube": "string",
"tiktok": "string"
}
}
Responses
Updated settings
application/json
JSON
{
"data": "string"
}