API ReferenceAdmin Saml Apps
Put Saml App Logo
PUT
/v1/admin/saml-apps/{sp_id}/branding/logosSet one branding logo slot (icon_logo / full_logo) for this SAML SP.
PUT is idempotent — re-PUT replaces the slot in place. Bytes are sanitised and
stored; the SP's branding.{slot}_url is set to the served
/static/uploads/{sha}.{ext} URL, which is returned. Requires the
branding:update capability on an SP in your tenant.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Path Parameters
sp_id*Sp Id
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A logo for one branding slot of the owning app (#714/#758).
The app is identified by the route's path ({client_id} / {sp_id}), so
only the slot + bytes travel in the body. logo_type selects the slot;
image_b64 is base64 of the raw image bytes (PNG / JPEG / WebP / SVG).
Response Body
application/json
application/json
curl -X PUT "https://example.com/v1/admin/saml-apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/branding/logos" \ -H "Content-Type: application/json" \ -d '{ "logo_type": "icon_logo", "image_b64": "string" }'{ "url": "string"}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}