Build API seems to have changed to `/builds/{buildId}`

David Wilson's Avatar

David Wilson

23 Oct, 2018 05:23 PM

Hey folks,

Today the Atom team noticed that we could no longer access build status using the documented API, but instead we received a 404 with the following body:

{"message":"Build not found or access denied."}

Here's a build URI using the documented format:

Through a bit of experimentation we discovered that changing /build/ to /builds/ causes the build link to work as expected:

Which API form is correct, the one above or the one specified in the API documentation? If this is a legitimate change we'll be happy to update our code.



  1. Support Staff 1 Posted by Feodor Fitsner on 23 Oct, 2018 05:29 PM

    Feodor Fitsner's Avatar

    Hi David,

    The original API for getting build details is still there. It has human-readable build version in its query string:{account}/{project-slug}/build/{version}

    And the newly added API method works with buildId and serves as a "permalink":{account}/{project-slug}/builds/{buildId}

    Please let me know if you have any questions.

  2. Support Staff 2 Posted by Ilya Finkelshte... on 23 Oct, 2018 05:34 PM

    Ilya Finkelshteyn's Avatar
  3. 3 Posted by David Wilson on 23 Oct, 2018 05:38 PM

    David Wilson's Avatar

    Hey Feodor,

    Is buildVersion the same thing as buildNumber? We were using buildNumber in the /build/ API in the past but it doesn't seem to work anymore. I may have misspoke when i used {buildId} in the original post.



  4. Support Staff 4 Posted by Feodor Fitsner on 23 Oct, 2018 05:40 PM

    Feodor Fitsner's Avatar

    Nope, [buildVersion] is what you see on UI, e.g. 1.0.0. buildNumber has never been supported in API though - buildNumber is just used to "derive" the next buildVersion.

  5. 5 Posted by David Wilson on 23 Oct, 2018 05:42 PM

    David Wilson's Avatar

    OK, thanks for the clarification! We'll switch our code to target the new /builds/ API that takes the buildId.

    Thanks for the help!


  6. Support Staff 6 Posted by Feodor Fitsner on 23 Oct, 2018 05:43 PM

    Feodor Fitsner's Avatar

    Sure, you are welcome!

  7. Feodor Fitsner closed this discussion on 02 Nov, 2018 05:42 PM.

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac