---
id: build-create
title: "Create a build"
description: "Create a new build."
sidebar_label: "Create a build"
hide_title: true
hide_table_of_contents: true
api: eJztWG1v2zYQ/ivEfdoAxfFbhkFAPqRZh2Uf2iBxsGKpEZyls8VWIlWSyksN/ffhSNmWbMftuq4bhgGGLFFH3sOH9xyPWkJKNjGydFIriOHcEDoSKBQ9iFkl87QHEThcWIhv4QU3wDQCXZJB7nKRQgzeLk58V4jAUlIZ6Z4gvl3CjNCQOatcBvHttJ5GYOhDRda90OkTxEtItHKkHN9iWeYy8eMev7OMZwk2yahAvnNPJUEMevaOEgdhHGkoZWCtnncyhQhmBlWSQQSJLgrpGHNpGLWTZLd8cY/N+FI5WpCBaIuZSUbi4ieh58JlJFrdhcvQ+UbPg5hRrtXCCqeZOnrEoswJ4uFoXK9xbdxZZ6Ra7PUWbDfDo7XkxANa78iJudFFxwUUKBXU60nvIa1LQmfiB5Bs5h1G3p7yIUyD4QhnCaMqyRSYS/X+85yuzYXTe31/mo/MudLGx8dNSy/RxfFgOBpDXdd1BE46b+YnESK/eWPIllrZwNKwP+C/XYRrFXgQtkoSsnZe5T0fd18hrPeGcgRBaekd8oN16Cq7G+BfENRrva8ZHAxHdfTttTIan/yvlX+RVjohtwfQXJuC30CKjo6cLGg/Ndevj378oT8QN5NzwVbWYVEyXQ8ZqS2OGo9dkMP+cHDU59+k34/973emqyrTPwtPVXmOMx7VmYr+MtwcrRMNjGcwD7uYOw53QR/GdyZaz8/rFyaZtEJagQfs6wiU+QIMzNGrq1cHvGuzQCU/eumfDmJMEl0pdzqMFRZkS0zodBS30sPpcDSO/Ting+GIgTXZ7bNEEGwPwClJpaEzqargBLtpkequNHphyFqOGJQ5cfLdJHWY7mwZV80u0Wwa4zdvdveJ81yScoKM0UastxWRVsRSleoec5kKqcrKCW1EIa2VaiFKNFiQI2O/2mYS6DnXKUe/xwMRFGQtLmh3+2hZfzrf/zKZXK7oT3RKwlBpyJJyPBdeDVtSIucyEUmbj++ot+hFYtzv82XAlxFfxt93Fm7c7/tE3cHyTCCciQKTTCo6MoQpB2/jy+Py+TBBRwtt5EeyARuZezKC17wy1A2ZGaZ3TcHK4Rho+wwQMyNpHomsKlBtkOzRYADHw63YeAsvMBVXwelb4IYbhZXLPOT0LXTJaVszxNWKfhpkmkq+xVyk5FDmVuBMV24DazuV8Lp6Pz7jFZhzYqVUeHaVQ6koXYd0O4LrOijkZJ9CrgP92wqRKvVxrhYClZDWViR0yLpnlxfCypT+Y9KwbSKaYDhhaZz0h3wZdRf+5J9TBU/WKMzvgtFdoOyb6eOicS+a0HnJNkEp3CITEjcK71H6zWtHMHu7/63SOVOiUvRYUuIobaakk6QyhtKeuMwJLQlnngQuUCqRoyOzUo3H5TLNB+1SW1+YIp+m4dhvQv7AzfOw/rxdmbxVzGEpe7yJlzk6FitXdcCH8NUZ/Zr1EcK6fVJfE8ADsQdvxvnQG/GpxN/8vKqsfv1tAgyVdXe1OeC/XFGwe+AejsabEj9U4+1inE1W9XCnHD5UqPI2PtfcnfkIazXo9Xt92Ozc4RsGl9jaugJ9luBypP3xY0XsVom2zjXPfSYJnDl6dMdl3pwv/IIsmzW7DYUD55SM1zK+heVyhpZuTF7X3PyhIsNfTqYR3KORofq6ndYRZIQpGb/I7+mJQQQ4RxN2y+Z5xe530mAdrXqcJQmV7qDttBVul6+vJ7zUzZeawqcaMPjA6RMfIAbgT0Hc20eQb1tCjmpReR1BGJMXBrtxtRVHflbNK1RPLYTLZbCY6Pek6hqiZiqOn6Ge1nX9B1smbE0=
sidebar_class_name: "post api-method"
info_path: docs/api/build
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 a build"}
>
</Heading>

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



Create a new build.

<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":["application_id","branch","commit"],"properties":{"application_id":{"type":"integer","description":"The ID of the application that the build belongs to.","example":234},"branch":{"type":"string","description":"The branch that the asset was built from.","example":"main"},"commit":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the commit that the build was built from.","example":"123abc"},"permalink":{"type":"string","description":"The permalink to the commit that the asset was built from.","example":"https://example.com/1234"}}}},"title":"buildCreate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"201":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","branch","commit","created_at","status"],"properties":{"id":{"type":"integer","description":"The ID of the build.","example":123},"application_id":{"type":"integer","description":"The ID of the application that the build belongs to.","example":345},"branch":{"type":"string","description":"The branch that the asset was built from.","example":"main"},"commit":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the commit that the build was built from.","example":"123abc"},"permalink":{"type":"string","description":"The permalink to the commit that the asset was built from.","example":"https://example.com/1234"}}},"created_at":{"type":"string","format":"date-time","description":"The ISO-8601 UTC timestamp of when the build was created.","example":"2021-01-01T00:00:00Z"},"updated_at":{"type":"string","format":"date-time","nullable":true,"description":"The ISO-8601 UTC timestamp of when the build was last updated.","example":"2021-01-02T00:00:00Z"},"description":{"type":"string","nullable":true,"description":"A description of the build.","example":"This is a description of the build."},"nrn":{"type":"string","nullable":true,"description":"The NRN of the build.","example":"organization=1:account=2:namespace=3:application=234:build=123"},"status":{"type":"string","description":"The status of the build.","example":"pending","enum":["pending","in_progress","failed","successful"]}},"title":"buildResponse"}}}},"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>