> ## Documentation Index > Fetch the complete documentation index at: https://docs.y.uno/llms.txt > Use this file to discover all available pages before exploring further. # Upload a Provider Logo > Uploads your own logo for a Yuno-owned provider. The image travels base64 in JSON, not multipart. Uploads your own logo for this provider. The image travels **base64 inside JSON**, not multipart. A logo is the provider's identity rather than its wording, so it follows the same rule as `name`: it is accepted **only for Yuno-owned providers** — a catalogue id containing `YUNO`, such as `YUNO_3DS` or `YUNO_FRAUD_SCREENING`. Uploading a logo for anyone else's provider is rejected with `400`. Writing a logo does not touch the instruction override, and does not add the provider to your allowlist. ### Image requirements | Rule | Detail | | ------------ | ------------------------------------------------------------------------------------ | | Format | PNG or JPEG, decided by the **file's own bytes** — an SVG renamed `.png` is refused. | | Shape | Square. It is drawn into the same fixed box as the catalogue's own icons. | | Minimum size | 200x200 pixels. | | Maximum size | 64 KB decoded. | | Request body | At most 256 KB, base64 included. Larger bodies are rejected with `413`. | ### Path Parameters Yuno catalogue provider id in UPPER\_SNAKE\_CASE, and it must be a Yuno-owned provider (the id contains `YUNO`). Case-insensitive — normalized to upper case. ### Body Original file name, at most 255 characters. Stored for display only — the format is decided by the bytes, never by this extension. The image itself, base64-encoded. ### Response Always `stored` on success. The stored key is not returned. Read the provider again with [Retrieve a Provider Overlay](/reference/organizations/whitelabel/retrieve-provider) to get a fresh presigned `logo_url`, which is the only kind of URL that exists for it. ```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}} curl -X PUT 'https://api.y.uno/v1/whitelabel/providers/YUNO_3DS/logo' \ -H 'public-api-key: ' \ -H 'private-secret-key: ' \ -H 'Content-Type: application/json' \ -d '{ "file_name": "acme.png", "base64_data": "" }' ``` ```json 200 OK theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}} { "status": "stored" } ``` ```json 400 — image too small theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}} { "title": "Invalid provider logo", "status": 400, "detail": "The logo was rejected", "violations": [ "The logo must be at least 200x200 pixels. This image is 1x1." ] } ``` `violations` lists **every** problem with the image at once — size, shape and format together — rather than one per round trip. ### Errors
| HTTP | Envelope | When | | ----- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `400` | `VALIDATION_ERROR` | `provider_id` is not a valid catalogue id. | | `400` | problem+json | The logo was rejected: not PNG/JPEG, not square, smaller than 200x200, larger than 64 KB decoded, a missing field, or the provider is not Yuno-owned. | | `401` | `NOT_AUTHENTICATED` | Missing or invalid API keys. | | `413` | — | Request body larger than 256 KB. |
## OpenAPI ````yaml openapi/organizations/whitelabel/upload-provider-logo.json PUT /whitelabel/providers/{provider_id}/logo openapi: 3.1.0 info: title: White-label Providers API - Upload Logo version: 1.0.0 servers: - url: https://api-sandbox.y.uno/v1 - url: https://api.eu.y.uno/v1 security: - sec0: [] sec1: [] paths: /whitelabel/providers/{provider_id}/logo: put: summary: Upload a Provider Logo description: >- Uploads your own logo for this provider. The image travels base64 in JSON, not multipart. A logo is the provider's identity rather than its wording, so it is held to the same rule as `name`: accepted only for Yuno-owned providers (a catalogue id containing `YUNO`) and rejected with `400` for anyone else's. The file must be a PNG or a JPEG — decided by the file's own bytes, never by the extension, so an SVG renamed `.png` is refused — and square, at least 200x200 pixels and at most 64 KB decoded. Rejections list every violation at once in `violations`. The stored key is not returned: read the provider again for a fresh presigned `logo_url`. Writing a logo does not touch the instruction override, and does not add the provider to your allowlist. operationId: upload-whitelabel-provider-logo parameters: - name: provider_id in: path required: true description: >- Yuno catalogue provider id in UPPER_SNAKE_CASE. Case-insensitive; normalized to upper case. schema: type: string example: YUNO_3DS requestBody: required: true description: The logo, base64-encoded. content: application/json: schema: type: object required: - file_name - base64_data properties: file_name: type: string maxLength: 255 description: >- Original file name, at most 255 characters. Stored for display only; the format is decided by the bytes, never by this extension. example: acme-risk.png base64_data: type: string description: >- The image itself, base64-encoded. PNG or JPEG only (checked against the file's magic bytes), square, at least 200x200 pixels and at most 64 KB decoded. example: >- iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg== responses: '200': description: Logo stored. content: application/json: schema: type: object properties: status: type: string description: Always `stored` on success. example: stored '400': description: >- The logo was rejected — invalid provider_id, not PNG/JPEG, not square, smaller than 200x200, larger than 64 KB decoded, or the provider is not Yuno-owned. content: application/json: schema: type: object properties: type: type: string example: about:blank title: type: string example: Invalid provider logo status: type: integer example: 400 detail: type: string example: The logo was rejected violations: type: array description: >- Every violation of the request, reported together rather than one per round trip. items: type: string example: - >- The logo must be at least 200x200 pixels. This image is 1x1. '401': description: Unauthorized — invalid or missing API keys. content: application/json: schema: type: object properties: code: type: string example: NOT_AUTHENTICATED messages: type: array items: type: string example: - Not authenticated '413': description: Request body larger than 256 KB. content: application/json: schema: type: object properties: code: type: string example: VALIDATION_ERROR messages: type: array items: type: string example: - Request body is too large components: securitySchemes: sec0: type: apiKey in: header name: PUBLIC-API-KEY x-default: sec1: type: apiKey in: header name: PRIVATE-SECRET-KEY x-default: ````