/v1/organization/logoAuthentication
Bearer API key or Facily session, subject to permissions and facility scope.
Authentication and scopeRequest example
Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.
curl --request DELETE \
--url 'https://api.staging.facily.ai/v1/organization/logo' \
--header "Authorization: Bearer $FACILY_API_KEY"Responses
Expand a status to inspect its schema. Generated examples show structure and synthetic values.
200Successful Response
{
"data": {
"accent_color": "string",
"created_at": "2026-10-29T12:00:00Z",
"id": "00000000-0000-4000-8000-000000000001",
"logo_url": "string",
"max_facilities": 0,
"name": "string",
"plan": {
"display_name": "string",
"id": "00000000-0000-4000-8000-000000000001",
"name": "string"
},
"primary_domain": "string",
"updated_at": "2026-10-29T12:00:00Z",
"logo_dark_url": "string",
"wide_logo_dark_url": "string",
"wide_logo_url": "string"
},
"meta": {
"request_id": "string"
}
}application/json
dataOrganizationResponserequiredShow data schema
accent_colorstring | nullrequiredBrand accent colour, as a hex code, applied to tenant-facing documents and messages.
Show accent_color schema
string | nullBrand accent colour, as a hex code, applied to tenant-facing documents and messages.
Variant 1: string
stringVariant 2: null
nullcreated_atstringrequiredWhen the organization was created.
Format: date-time
idstringrequiredUnique identifier for this organization.
Format: uuid
logo_dark_urlstring | nullPublic URL of the dark-mode version of the square logo, or null when none has been uploaded. A client on a dark surface should fall back to `logo_url`; a client on a light surface should never use it.
Show logo_dark_url schema
string | nullPublic URL of the dark-mode version of the square logo, or null when none has been uploaded. A client on a dark surface should fall back to `logo_url`; a client on a light surface should never use it.
Variant 1: string
stringVariant 2: null
nulllogo_urlstring | nullrequiredPublic URL of the organization's square logo. Null when no logo has been uploaded.
Show logo_url schema
string | nullPublic URL of the organization's square logo. Null when no logo has been uploaded.
Variant 1: string
stringVariant 2: null
nullmax_facilitiesintegerrequiredHow many facilities the current plan permits.
namestringrequiredThe storage company's name.
planOrganizationPlanResponserequiredShow plan schema
display_namestringrequiredidstringrequiredFormat: uuid
namestringrequiredprimary_domainstring | nullrequiredThe organization's main web domain.
Show primary_domain schema
string | nullThe organization's main web domain.
Variant 1: string
stringVariant 2: null
nullupdated_atstringrequiredWhen the organization was last modified.
Format: date-time
wide_logo_dark_urlstring | nullPublic URL of the dark-mode version of the wide logo, or null when none has been uploaded. A client on a dark surface should fall back to `wide_logo_url`; a client on a light surface should never use it.
Show wide_logo_dark_url schema
string | nullPublic URL of the dark-mode version of the wide logo, or null when none has been uploaded. A client on a dark surface should fall back to `wide_logo_url`; a client on a light surface should never use it.
Variant 1: string
stringVariant 2: null
nullwide_logo_urlstring | nullPublic URL of the organization's wide/horizontal logo, for slots a square mark suits badly (the sign-in screen, email headers). Independent of `logo_url`: either, both or neither may be set, so a client wanting one must not fall back to the other silently.
Show wide_logo_url schema
string | nullPublic URL of the organization's wide/horizontal logo, for slots a square mark suits badly (the sign-in screen, email headers). Independent of `logo_url`: either, both or neither may be set, so a client wanting one must not fall back to the other silently.
Variant 1: string
stringVariant 2: null
nullmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired400Validation error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired401Unauthenticated
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired403Permission denied
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired404Not found
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired409Business logic error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired503Temporary failure
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired