---
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
canonical: 'https://docs.nullplatform.com/docs/api/application-update'
---
<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","readOnly":true,"description":"A system-wide unique ID for the application. Assigned by nullplatform.","example":1234},"nrn":{"type":"string","readOnly":true,"description":"The NRN (Nullplatform Resource Name) uniquely identifying this application in the nullplatform hierarchy. Built by nullplatform from the entity 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,"readOnly":true,"description":"A namespace-wide unique slug for the application. nullplatform derives it from the name when the application is created: you can't send it, and it never changes afterwards.","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>