> ## Documentation Index > Fetch the complete documentation index at: https://docs.useroutr.com/llms.txt > Use this file to discover all available pages before exploring further. # Upload the application's logo > The request body is the image itself, sent with `Content-Type` `image/png`, `image/jpeg` or `image/webp`. The logo must be a still image of at most 256 KB, between 64 and 1024 pixels on each side. Its type is read from the file, not from the header. Uploading the logo the application already has changes nothing. The logo appears on the hosted checkout and in `branding.logo_url`. ## OpenAPI ````yaml /api-reference/openapi.json put /v1/applications/{id}/logo openapi: 3.1.0 info: title: Useroutr API version: '1' description: >- Application funding infrastructure. Two authentication layers exist and are never interchangeable: developer backends authenticate with an application API key (`apiKey`), and the Useroutr dashboard authenticates a human with a Useroutr account session (`userSession`, obtained from `/v1/auth/sign-in`). Platform operations use the operator platform key. Every response carries an `X-Request-ID` header that also appears in error envelopes. servers: - url: https://api.sandbox.useroutr.com description: 'Sandbox: ur_test_ keys, Stellar testnet' - url: https://api.useroutr.com description: 'Production: ur_live_ keys' security: [] tags: - name: Funding Intents description: Funding intent lifecycle - name: Quotes description: 'Route quotes: what a payer must send from a chosen source asset' - name: Checkout description: Public, token-addressed payer view - name: Payments description: Observed payments - name: Settlements description: Settlement state and protocol evidence - name: Refunds description: Refund requests for payments that did not satisfy an intent - name: Ledger description: Application balances and ledger entries - name: Webhooks description: Webhook endpoints, events and deliveries - name: Assets description: Supported assets - name: Applications description: Application registration and credentials - name: Request logs description: Requests made with the application's API keys, kept for 30 days paths: /v1/applications/{id}/logo: put: tags: - Applications summary: Upload the application's logo description: >- The request body is the image itself, sent with `Content-Type` `image/png`, `image/jpeg` or `image/webp`. The logo must be a still image of at most 256 KB, between 64 and 1024 pixels on each side. Its type is read from the file, not from the header. Uploading the logo the application already has changes nothing. The logo appears on the hosted checkout and in `branding.logo_url`. parameters: - schema: type: string minLength: 1 maxLength: 64 in: path name: id required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: id: type: string object: type: string enum: - application name: type: string description: type: - string - 'null' status: type: string enum: - ACTIVE - SUSPENDED - ARCHIVED default_destination: anyOf: - type: object properties: network: type: string minLength: 1 maxLength: 32 asset: type: string minLength: 1 maxLength: 100 address: type: string minLength: 1 maxLength: 128 required: - network - asset - address additionalProperties: false - type: 'null' branding: type: object properties: brand_color: type: - string - 'null' logo_url: type: - string - 'null' required: - brand_color - logo_url additionalProperties: false created_at: type: string updated_at: type: string required: - id - object - name - description - status - default_destination - branding - created_at - updated_at additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '409': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '413': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '415': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '422': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false '503': description: Default Response content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - BAD_REQUEST - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - IDEMPOTENCY_REQUEST_IN_PROGRESS - APPLICATION_INACTIVE - INVALID_AMOUNT - UNSUPPORTED_ASSET - INVALID_DESTINATION - INVALID_EXPIRATION - PROTOCOL_REJECTED - PROTOCOL_UNAVAILABLE - NO_ROUTE_AVAILABLE - INSUFFICIENT_INPUT - QUOTE_EXPIRED - QUOTE_NOT_SELECTABLE - QUOTE_NOT_LOCKED - EXECUTION_NOT_FAILED - EXECUTION_NOT_RESUMABLE - LOGO_FORMAT_UNSUPPORTED - LOGO_DIMENSIONS_INVALID - LOGO_STORAGE_UNAVAILABLE - ROUTE_UNAVAILABLE - RATE_LIMITED - INVALID_CREDENTIALS - EMAIL_NOT_VERIFIED - EMAIL_ALREADY_REGISTERED - SESSION_EXPIRED - INVALID_TOKEN - INTERNAL_ERROR message: type: string requestId: type: string retryable: type: boolean details: type: array items: type: object properties: path: type: string message: type: string required: - path - message additionalProperties: false required: - code - message - requestId additionalProperties: false required: - error additionalProperties: false security: - apiKey: [] x-codeSamples: - lang: typescript label: Node.js SDK source: >- import { readFile } from "node:fs/promises"; import { Useroutr } from "@useroutr/sdk"; const useroutr = new Useroutr({ apiKey: process.env.USEROUTR_API_KEY }); const application = await useroutr.applications.setLogo( "app_5c1e0a9f", await readFile("logo.png"), "image/png", ); - lang: bash label: cURL source: >- curl -X PUT "https://api.sandbox.useroutr.com/v1/applications/app_5c1e0a9f/logo" \ -H "Authorization: Bearer $USEROUTR_API_KEY" \ -H "Content-Type: image/png" \ --data-binary @logo.png components: securitySchemes: apiKey: type: http scheme: bearer description: >- Application API authentication for developer backends: `Authorization: Bearer ur_test_...` or `ur_live_...`. Resolves the application, its environment and the key's status. Never a dashboard login. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.