---
id: application-create
title: "Create an application"
description: "Creates a new application in an existing namespace."
sidebar_label: "Create an application"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post 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={"Create an application"}
>
</Heading>

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



Creates a new application in an existing namespace.

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

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","required":["name","namespace_id","repository_url"],"properties":{"name":{"type":"string","maxLength":60,"description":"The application name.","example":"Billing API"},"namespace_id":{"type":"integer","description":"The ID of the namespace that owns this application.","example":1234},"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},"template_id":{"type":"integer","description":"The ID of the template that was used to create this application.","example":2345},"auto_deploy_on_creation":{"type":"boolean","description":"True if the application must be deployed immediately after being created, false otherwise.","example":false},"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":"applicationCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"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>