---
id: application-update
title: "Update an application"
description: "Updates information for an application. Applications accept partial updates only: `PUT` on this path answers `405 Method Not Allowed`."
sidebar_label: "Update an application"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "patch api-method"
info_path: docs/api/application
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Update an application"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/application/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Updates information for an application. Applications accept partial updates only: `PUT` on this path answers `405 Method Not Allowed`.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"id","in":"path","required":true,"description":"The ID of the application to update","schema":{"type":"string"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":60,"description":"The application name. \n\n> ℹ️ **Note:** Changing the application's name **does not change the slug**, \nas doing so could break connections with existing applications and services.\n","example":"Billing API"},"status":{"type":"string","enum":["pending","creating","updating","active","inactive","failed","deleting"],"description":"The status of the application.","example":"active"},"repository_url":{"type":"string","maxLength":250,"description":"The URL of the repository that holds this application.","example":"https://github.com/crypto-inc/accounting-billing-api"},"template_id":{"type":"integer","description":"The ID of the template used to create this application. \n\n > ℹ️ **Note:** If you patch the template, make sure that the new template is compatible with the\n repository URL, especially if it includes rules.\n","example":3456},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}},"settings":{"type":"object","nullable":true,"description":"Configuration settings for the application. When updating via PATCH, follows RFC 7396 (JSON Merge Patch): keys with null values are deleted, keys with non-null values are updated/created, omitted keys are preserved.","properties":{"defaults":{"type":"object","nullable":true,"description":"Default values nullplatform falls back to when a branch or environment isn't specified explicitly.","properties":{"branch":{"type":"string","nullable":true,"description":"Default branch name for the application.","example":"main"},"environment":{"type":"string","nullable":true,"description":"Default environment name for the application.","example":"staging"}}},"asset":{"type":"object","nullable":true,"description":"Settings describing where the application's build assets are stored.","properties":{"docker_server":{"type":"object","nullable":true,"description":"Settings for the application's Docker server assets.","properties":{"uri":{"type":"string","nullable":true,"description":"Location where the application's Docker server assets are stored.","example":"registry.example.com/acme-corp/billing-api"}}},"ecr":{"type":"object","nullable":true,"description":"Amazon ECR repository where the application's assets are stored.","properties":{"uri":{"type":"string","nullable":true,"description":"ECR repository URI for the application's assets.","example":"123456789012.dkr.ecr.us-east-1.amazonaws.com/billing-api"},"arn":{"type":"string","nullable":true,"description":"ECR repository ARN for the application's assets.","example":"arn:aws:ecr:us-east-1:123456789012:repository/billing-api"}}}}},"code_repository":{"type":"object","nullable":true,"description":"Configuration of the code repository provider the application is linked to.","properties":{"specification_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository specification.","example":"7f3c910e-8138-4d65-9d09-b97d89f2c509"},"specification_slug":{"type":"string","nullable":true,"description":"Slug of the code repository specification.","example":"github-configuration"},"specification_name":{"type":"string","nullable":true,"description":"Display name of the code repository specification.","example":"GitHub"},"specification_icon":{"type":"string","nullable":true,"description":"Icon identifier for the code repository specification.","example":"github"},"provider_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository provider.","example":"82eee42c-46c9-4bb7-a53d-c08b027817f3"}}}},"title":"applicationSettings"}},"title":"application_write"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"204":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","name","slug","status","namespace_id","repository_url","is_mono_repo","auto_deploy_on_creation","template_id"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the application.","example":1234},"nrn":{"type":"string","description":"The NRN (Nullplatform Resource Name) uniquely identifying this application in the nullplatform hierarchy.","example":"organization=1:account=2:namespace=3:application=4"},"name":{"type":"string","maxLength":60,"description":"The application name.","example":"Billing API"},"slug":{"type":"string","maxLength":60,"description":"A namespace-wide unique slug for the application.","example":"billing-api"},"namespace_id":{"type":"integer","description":"The ID of the namespace that owns this application.","example":2345},"status":{"type":"string","enum":["pending","creating","updating","active","inactive","failed","deleting"],"description":"The status of the application.","example":"active"},"repository_url":{"type":"string","maxLength":250,"description":"The URL of the repository that holds this application.","example":"https://github.com/crypto-inc/accounting-billing-api"},"repository_app_path":{"type":"string","description":"The folder where the application is located inside a monorepo.","example":null,"nullable":true},"is_mono_repo":{"type":"boolean","description":"True if the application shares the repository with other apps, false otherwise.","example":false},"auto_deploy_on_creation":{"type":"boolean","description":"True if the application must be deployed immediately after being created, false otherwise.","example":false},"template_id":{"type":"integer","description":"The ID of the template used to create this application.","example":3456},"metadata":{"type":"object","description":"The metadata loaded via the metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata.","example":"key"},"value":{"type":"string","description":"The value of the metadata.","example":"value"},"additional_properties":{"type":"object","description":"Additional properties of the metadata.","properties":{"schemas":{"type":"array","description":"The JSON schemas of the metadata."},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}}}}},"title":"MetadataComponent"},"settings":{"type":"object","nullable":true,"description":"Configuration settings for the application. When updating via PATCH, follows RFC 7396 (JSON Merge Patch): keys with null values are deleted, keys with non-null values are updated/created, omitted keys are preserved.","properties":{"defaults":{"type":"object","nullable":true,"description":"Default values nullplatform falls back to when a branch or environment isn't specified explicitly.","properties":{"branch":{"type":"string","nullable":true,"description":"Default branch name for the application.","example":"main"},"environment":{"type":"string","nullable":true,"description":"Default environment name for the application.","example":"staging"}}},"asset":{"type":"object","nullable":true,"description":"Settings describing where the application's build assets are stored.","properties":{"docker_server":{"type":"object","nullable":true,"description":"Settings for the application's Docker server assets.","properties":{"uri":{"type":"string","nullable":true,"description":"Location where the application's Docker server assets are stored.","example":"registry.example.com/acme-corp/billing-api"}}},"ecr":{"type":"object","nullable":true,"description":"Amazon ECR repository where the application's assets are stored.","properties":{"uri":{"type":"string","nullable":true,"description":"ECR repository URI for the application's assets.","example":"123456789012.dkr.ecr.us-east-1.amazonaws.com/billing-api"},"arn":{"type":"string","nullable":true,"description":"ECR repository ARN for the application's assets.","example":"arn:aws:ecr:us-east-1:123456789012:repository/billing-api"}}}}},"code_repository":{"type":"object","nullable":true,"description":"Configuration of the code repository provider the application is linked to.","properties":{"specification_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository specification.","example":"7f3c910e-8138-4d65-9d09-b97d89f2c509"},"specification_slug":{"type":"string","nullable":true,"description":"Slug of the code repository specification.","example":"github-configuration"},"specification_name":{"type":"string","nullable":true,"description":"Display name of the code repository specification.","example":"GitHub"},"specification_icon":{"type":"string","nullable":true,"description":"Icon identifier for the code repository specification.","example":"github"},"provider_id":{"type":"string","format":"uuid","nullable":true,"description":"Unique identifier of the code repository provider.","example":"82eee42c-46c9-4bb7-a53d-c08b027817f3"}}}},"title":"applicationSettings"}},"title":"application"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>