{"_id":"57048a488c69510e00b1df8d","project":"55d2023b3c74062300aee506","user":{"_id":"55d201fe945e481700afbb19","username":"","name":"Abhik Pramanik"},"initVersion":{"_id":"5702fc1618ad001700a29585","version":"1.0"},"__v":2,"createdAt":"2016-04-06T04:02:16.865Z","changelog":[{"_id":"57048a488c69510e00b1df8e","update":"[Update User on a Project Team](doc:update-user-on-a-project-team)","type":"added"},{"_id":"57048b40849f721900f277a4","update":"[Remove Snapshot from Project](doc:remove-snapshot-from-project)","type":"added"},{"_id":"57048b40849f721900f277a3","update":"[Retrieve Sheets in a Project](doc:retrieve-sheets-in-a-project)","type":"added"},{"_id":"57048b40849f721900f277a5","update":"API version is now specified via `Accept` header","type":"improved"},{"_id":"57048b40849f721900f277a2","update":"404 error messages are now consistent","type":"improved"},{"_id":"57048b40849f721900f277a1","update":"","type":"added"}],"body":"[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/HHU0Dm0JR7ScXfCHEbfj_giphy.gif\",\n        \"giphy.gif\",\n        \"400\",\n        \"202\",\n        \"#2d25e3\",\n        \"\"\n      ],\n      \"caption\": \"(Giphy.com)\"\n    }\n  ]\n}\n[/block]\nIt's finally here: we've moved the PlanGrid API out of beta and officially cut `1.0.0`. In this inaugural release, we've added three endpoints and changed how you specify the API version. You can now:\n- Retrieve the metadata of all published sheets on a project (e.g. the drawing log)\n- Update the role of a user on a project team\n- Remove a snapshot from a project\n\n*More importantly, you'll need to update how you send requests to the PlanGrid API.* In the beta, you would specify the `MAJOR` version of the API in the URI (e.g. `https://io.plangrid.com/v1/projects`). This is not a RESTful way to represent a resource, requires URIs to change if a new version of the API is released, and makes it harder to support specifying `MINOR` and `PATCH` versions (we don't right now, but may want to in the future). In `1.0.0`, we moved specification of the API version (just `MAJOR` for now) to an `Accept` header. Here's an example request with the new header using `curl`:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl -i https://io.plangrid.com/projects -u [[app:key]]: -H \\\"Accept: application/vnd.plangrid+json; version=1\\\"\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\nSee [API Versioning](doc:api-versioning) for details.","slug":"100","title":"1.0.0"}

1.0.0


[block:image] { "images": [ { "image": [ "https://files.readme.io/HHU0Dm0JR7ScXfCHEbfj_giphy.gif", "giphy.gif", "400", "202", "#2d25e3", "" ], "caption": "(Giphy.com)" } ] } [/block] It's finally here: we've moved the PlanGrid API out of beta and officially cut `1.0.0`. In this inaugural release, we've added three endpoints and changed how you specify the API version. You can now: - Retrieve the metadata of all published sheets on a project (e.g. the drawing log) - Update the role of a user on a project team - Remove a snapshot from a project *More importantly, you'll need to update how you send requests to the PlanGrid API.* In the beta, you would specify the `MAJOR` version of the API in the URI (e.g. `https://io.plangrid.com/v1/projects`). This is not a RESTful way to represent a resource, requires URIs to change if a new version of the API is released, and makes it harder to support specifying `MINOR` and `PATCH` versions (we don't right now, but may want to in the future). In `1.0.0`, we moved specification of the API version (just `MAJOR` for now) to an `Accept` header. Here's an example request with the new header using `curl`: [block:code] { "codes": [ { "code": "curl -i https://io.plangrid.com/projects -u [[app:key]]: -H \"Accept: application/vnd.plangrid+json; version=1\"", "language": "curl" } ] } [/block] See [API Versioning](doc:api-versioning) for details.
added
[Update User on a Project Team](doc:update-user-on-a-project-team)
added
[Remove Snapshot from Project](doc:remove-snapshot-from-project)
added
[Retrieve Sheets in a Project](doc:retrieve-sheets-in-a-project)
improved
API version is now specified via `Accept` header
improved
404 error messages are now consistent