---
title: "Upload application avatar"
method: POST
path: "/applications/{application}/avatar"
tags: ["Applications"]
---

# Upload application avatar

`POST /applications/{application}/avatar`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/applications/{application}/avatar`
- Auth: HTTP bearer

Upload or replace the avatar for an application.

## Path parameters

- `application` string, required

## Request body `multipart/form-data`

- object
  - `avatar` string, binary, required: Maximum file size: 3072 kilobytes.

## Response `200`

`ApplicationResource`

- object
  - `data` ApplicationResource, required
    - `id` string, required
    - `type` 'applications', required
    - `attributes` object
      - `name` string, required
      - `slug` string, required
      - `region` 'us-east-1' | 'us-east-2' | 'ca-central-1' | 'eu-central-1' | 'eu-west-1' | 'eu-west-2' | 'eu-west-3' | 'me-central-1' | 'ap-southeast-1' | 'ap-southeast-2' | 'ap-northeast-1', required
      - `root_directory` string, nullable, required
      - `slack_channel` string, nullable, required
      - `avatar_url` string, required
      - `notes` string, nullable
      - `framework` 'laravel' | 'symfony' | 'jigsaw' | 'html' | 'php' | 'express' | 'hono' | 'nuxt' | 'next' | 'tanstack' | 'elysia' | 'nestjs' | 'astro' | 'javascript' | 'go' | 'hugo' | 'ruby' | 'rails' | 'jekyll' | 'django' | 'fastapi' | 'flask' | 'pelican' | 'python' | 'java' | 'spring' | 'rust' | 'zola' | 'axum' | 'rocket' | 'actix' | 'warp', required
      - `language` 'html' | 'php' | 'javascript' | 'python' | 'go' | 'ruby' | 'java' | 'rust', required
      - `created_at` string, date-time, nullable, required
      - `repository` object, nullable, required
        - `full_name` string, required
        - `default_branch` string, required
    - `relationships` object
      - `repository` object
        - `data` RepositoryResourceIdentifier, required
          - `type` 'repositories', required
          - `id` string, required
      - `organization` object
        - `data` OrganizationResourceIdentifier, required
          - `type` 'organizations', required
          - `id` string, required
      - `environments` object
        - `data` EnvironmentResourceIdentifier[], required
          - `type` 'environments', required
          - `id` string, required
      - `deployments` object
        - `data` DeploymentResourceIdentifier[], required
          - `type` 'deployments', required
          - `id` string, required
      - `defaultEnvironment` object
        - `data` EnvironmentResourceIdentifier, required
          - `type` 'environments', required
          - `id` string, required
  - `included` union[]
    - union
      - RepositoryResource
        - `id` string, required
        - `type` 'repositories', required
        - `attributes` object
          - `name` string, required
      - OrganizationResource
        - `id` string, required
        - `type` 'organizations', required
        - `attributes` object
          - `name` string, required
          - `slug` string, required
      - EnvironmentResource
        - `id` string, required
        - `type` 'environments', required
        - `attributes` object
          - `name` string, required
          - `slug` string, required
          - `status` 'deploying' | 'running' | 'hibernating' | 'stopped', required
          - `color` 'blue' | 'green' | 'orange' | 'purple' | 'red' | 'yellow' | 'cyan' | 'gray', required
          - `created_from_automation` boolean, required
          - `vanity_domain` string, required
          - `framework` 'laravel' | 'symfony' | 'jigsaw' | 'html' | 'php' | 'express' | 'hono' | 'nuxt' | 'next' | 'tanstack' | 'elysia' | 'nestjs' | 'astro' | 'javascript' | 'go' | 'hugo' | 'ruby' | 'rails' | 'jekyll' | 'django' | 'fastapi' | 'flask' | 'pelican' | 'python' | 'java' | 'spring' | 'rust' | 'zola' | 'axum' | 'rocket' | 'actix' | 'warp', required
          - `language` 'html' | 'php' | 'javascript' | 'python' | 'go' | 'ruby' | 'java' | 'rust', required
          - `php_major_version` string, required
          - `serving` string
          - `build_command` string, nullable, required
          - `node_version` '20' | '22' | '24' | '26', required
          - `deploy_command` string, nullable, required
          - `start_command` string, nullable, required
          - `uses_octane` boolean, required
          - `uses_hibernation` boolean, required
          - `hibernation_wake_up_interval` integer, nullable, required
          - `timeout` integer, required: The number of seconds the environment will wait for your application to respond before timing out. Changes take effect on the next deployment.
          - `shutdown_timeout` integer, required: The number of seconds to wait before stopping the previous deployment's compute instances, allowing it to finish processing requests and jobs after a new deployment becomes active. Changes take effect on the next deployment.
          - `uses_push_to_deploy` boolean, required
          - `uses_deploy_hook` boolean, required
          - `resend` object, nullable, required
            - `from_address` string, required
            - `from_name` string, required
            - `key_name` string, required
          - union
            - object
              - …
            - string[]
          - `network_settings` object, required
            - `cache` object, required
              - …
            - `response_headers` object, required
              - …
            - `firewall` object, required
              - …
            - `content_converter` boolean, required
          - `created_at` string, date-time, nullable, required
        - `relationships` object
          - `application` object
            - `data` ApplicationResourceIdentifier, required
              - …
          - `branch` object
            - `data` BranchResourceIdentifier, required
              - …
          - `deployments` object
            - `data` DeploymentResourceIdentifier[], required
              - …
          - `currentDeployment` object
            - `data` DeploymentResourceIdentifier, required
              - …
          - `domains` object
            - `data` DomainResourceIdentifier[], required
              - …
          - `primaryDomain` object
            - `data` DomainResourceIdentifier, required
              - …
          - `instances` object
            - `data` InstanceResourceIdentifier[], required
              - …
          - `database` object
            - `data` DatabaseSchemaResourceIdentifier, required
              - …
          - `cache` object
            - `data` CacheResourceIdentifier, required
              - …
          - `buckets` object
            - `data` FilesystemResourceIdentifier[], required
              - …
          - `websocketApplication` object
            - `data` WebsocketApplicationResourceIdentifier, required
              - …
          - `secrets` object
            - `data` SecretResourceIdentifier[], required
              - …
        - `links` object, required
          - `self` Link, required
            - `href` string, uri, required
            - `rel` string
            - `describedby` string
            - `title` string
            - `type` string
            - `hreflang` union
              - …
            - `meta` object
      - DeploymentResource
        - `id` string, required
        - `type` 'deployments', required
        - `attributes` object
          - `slug` string, required
          - `status` 'pending' | 'build.pending' | 'build.created' | 'build.queued' | 'build.running' | 'build.succeeded' | 'build.failed' | 'cancelled' | 'failed' | 'deployment.pending' | 'deployment.created' | 'deployment.queued' | 'deployment.running' | 'deployment.succeeded' | 'deployment.failed', required
          - `branch_name` string, required
          - `commit_hash` string, required
          - `commit_message` string, required
          - `commit_author` string, nullable, required
          - `failure_reason` string, nullable, required: Why the deployment did not finish. For `build.failed` and `deployment.failed`, the get deployment endpoint returns the output of the failed step, or a description when no failed step is found. The list endpoint returns the stored reason as is.
          - `php_major_version` string, required
          - `build_command` string, nullable, required
          - `node_version` '20' | '22' | '24' | '26', required
          - `uses_octane` boolean, required
          - `uses_hibernation` boolean, required
          - `hibernation_wake_up_interval` integer, nullable, required
          - `started_at` string, date-time, nullable, required
          - `finished_at` string, date-time, nullable, required
        - `relationships` object
          - `environment` object
            - `data` EnvironmentResourceIdentifier, required
              - …
          - `initiator` object
            - `data` UserResourceIdentifier, required
              - …
        - `links` object, required
          - `self` Link, required
            - `href` string, uri, required
            - `rel` string
            - `describedby` string
            - `title` string
            - `type` string
            - `hreflang` union
              - …
            - `meta` object

## Other responses

- `403`: Authorization error
- `404`: Not found
- `422`: Validation error

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)