---
id: build-update
title: "Update a build"
description: "Updates a build."
sidebar_label: "Update a build"
hide_title: true
hide_table_of_contents: true
api: eJzdWG1v2zYQ/ivEfVoBxfFbhkFAPrhZh2YfuiB1sGKpEZzFs8VWIlWSSpoa+u/DkXIsvzTJulcMMGSLOvEePnzujucVeFw6SK/hZa0KCbMEJLnMqsoroyGFq0qiJydQzNmgBwmYiizy43MJKYThtA5mkICjrLbK30N6vYI5oSU7qX0O6fWsmSVQocWSPFkXDDSWBCkoCQkodlehzyEBS59qZUlC6m1NCbgspxIhXYG/r8Ib2tOSLDS7eKc5ifMfhVkIn1PELLwRljBgp89YVgVBOhiOGA87IudfGnnPs+/6zYz2pD0/wqoqVBbWffzBsa/VPiwz/0CZhwQqyyx5RS7YefS169g5b5VewiHw0XZrAVvAoSIt48uk65K3bjOi9E1lzdKSc5DAAlVBTK2rs4ycW9QFzJomAa98mCrMHncYmoafWHKV0S7CHvb7/LWPMdJ6h07EfQ8Iv5mrDenXUQlzizrLw5Rlqdgks8RubpBvWjZnuywreUAgz9DHni6S7gJuvmHazuvC5+g7WpxTYfTSCW+23I7GJ83Dwp+lk2i7mR6dIx/2hB15sbCm3BZOiUpzwLSsPqnarYU/gmSz7jjz7pIfwzQYjnCeMaqKbImF0h+f5/TBnKP7kO+n+ci9r1x6fNyO9DJTHg+GozGESOhI7gCghbElPwGW/5FXJR2m5u0vRz983x+Iq+mZYCvnsayYrruc9A5HrcdtkMP+cHDU58+030/D5zemqw28PwJP10WBc541Jrc/CbdA57vxfwDzcBvzlsN90I/jm4jO/SPpcZorJxQXrK/bNwlo+w0YmKM3l28e8W7sErX6EkL/dJBilpla+9NhypXOVZjR6SjtpIfT4WichnlOB8MRA/tP14rLtjy01WL87t1+gTgrFGkvyFpjxUM9EbImDlWlb7FQUihd1V4YK0rlnNJLsTkZ/GXFJNJzZiSrP+CBBEpyDpe0Xz461k/n+9fT6cWa/sxIEpYqS46057XwbriKMrVQmci6fHxHvWUvEeN+ny8Dvoz4Mn6xtXHjfj8k6i0sXxHCRJSY5UrTER9yWLytr4Ar5MMMPS2NVV/IRWxkb8kK3vPa0rZk5ihv2lMRyzHS9gwQc6tokYi8LlFvkByIwQiOp1uz8R5eohSX0el74IErjbXPA2T5HrbJ6VozxPWOPg1SSsU/sRCSPKrCCZyb2m9g7aYS3tfgJ2S8EgtOrCRFYFd7VJrkg6S7Cm6aGCEnhyLkbaR/N0KUlkHneilQC+VcTcLErDu5OBdOSfqfhYbrEtGK4YRD46Q/5Mtoe+NP/r2o4MVajcVNNLqJlP1j8XHeuhetdF6xTYwUHlEZiSuNt6hC8doLmIOv/62hM9Gi1vS5osyTbJdksqy2lmRPXBSEjoS39wKXqLQo0JNdR03A5XMjYz8YOoHQF6ZwHKrQ8UrJJvSavJrYSda26BzpsFI9LuVVgZ5Dls92wP3euj19y1ESxd1tUh9o4Img7TtDVgxG3JuEHz+tz1c//zoFBszRd7npJV+tidj0fg+Vt+HSuzD8jNFHfge9fq8Pm2obu3E+FhvnSwyR3TbLsV9bN+S7O7Xa5IdDvXu7PE+f/XFVtA1B4G7VcnwN63lTFf4PyI3zPLxazdHRlS2ahoc/1WS5y58lcItWxUPT9QqkcvxbQrrAwu0eobrwvrtsE9IL8UTXfhB1O4j6HhhCUfMdJPCR7uNfCs2sSSAnlGQDsvjgLPo/mvLrmxf3UmmTrN+YZBlV/lHbWUeyF5Pp2WtWSvufQhnyFVi84xyMdxGlCYQEAYaxFRSol3UIRoiTsq5wW5Y7MgzLOsjDahUtpuYj6aZ5oMXzPTPTNL8DLLUlHg==
sidebar_class_name: "patch 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={"Update a build"}
>
</Heading>

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



Updates a build.

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

<ParamsDetails
  parameters={[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The ID of the build to read.","example":123}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","description":"The status of the build.","example":"pending","enum":["pending","in_progress","failed","successful"]}},"title":"buildUpdate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The build was updated.","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>