> ## 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.

# Update application configuration



## OpenAPI

````yaml /api-reference/openapi.json patch /v1/applications/{id}
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}:
    patch:
      tags:
        - Applications
      summary: Update application configuration
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
          in: path
          name: id
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 120
                description:
                  anyOf:
                    - type: string
                      maxLength: 500
                    - type: 'null'
                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
                    - type: 'null'
                brand_color:
                  anyOf:
                    - type: string
                      pattern: ^#([0-9a-f]{3}|[0-9a-f]{6})$
                    - type: 'null'
      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
        '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
      security:
        - apiKey: []
      x-codeSamples:
        - lang: typescript
          label: Node.js SDK
          source: >-
            import { Useroutr } from "@useroutr/sdk";


            const useroutr = new Useroutr({ apiKey: process.env.USEROUTR_API_KEY
            });


            const application = await
            useroutr.applications.update("app_5c1e0a9f", {
              brand_color: "#1d4ed8",
            });
        - lang: bash
          label: cURL
          source: >-
            curl -X PATCH
            "https://api.sandbox.useroutr.com/v1/applications/app_5c1e0a9f" \
              -H "Authorization: Bearer $USEROUTR_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"brand_color":"#1d4ed8"}'
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.