# Versionary: Elixir plug for handling API versioning

**URL:** <https://forum.elixirforum.com/t/versionary-elixir-plug-for-handling-api-versioning/4197>\
**Category:** Announcing\
**Tags:** api, library, plug, phoenix\
**Created:** [March 18, 2017, 6:31pm UTC](https://forum.elixirforum.com/t/versionary-elixir-plug-for-handling-api-versioning/4197 "2017-03-18T18:31:11Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![anthonator](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/anthonator/32/14467_2.png) [@anthonator](https://forum.elixirforum.com/u/anthonator)\
**Post date:** [March 18, 2017, 6:31pm UTC](https://forum.elixirforum.com/t/versionary-elixir-plug-for-handling-api-versioning/4197/1 "2017-03-18T18:31:11Z")

</div>

Recently put together Versionary. A plug which makes it simple to handle versioning in your API. It hasn’t been released yet but is ready to go. Was hoping to get some feedback from the community before publishing it.

> **[GitHub - sticksnleaves/versionary: Plug for API versioning](https://github.com/sticksnleaves/versionary)**
>
> Plug for API versioning

---

<div class="post-metadata">

**Author:** ![anthonator](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/anthonator/32/14467_2.png) [@anthonator](https://forum.elixirforum.com/u/anthonator)\
**Post date:** [March 19, 2017, 6:34pm UTC](https://forum.elixirforum.com/t/versionary-elixir-plug-for-handling-api-versioning/4197/2 "2017-03-19T18:34:12Z")

</div>

Version 0.1.0 of Versionary has been released.

GitHub: [GitHub - sticksnleaves/versionary: Plug for API versioning · GitHub](https://github.com/sticksnleaves/versionary)  
Documentation: [API Reference — Versionary v0.4.1](https://hexdocs.pm/versionary/api-reference.html)

---

<div class="post-metadata">

**Author:** ![anthonator](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/anthonator/32/14467_2.png) [@anthonator](https://forum.elixirforum.com/u/anthonator)\
**Post date:** [May 6, 2017, 6:44am UTC](https://forum.elixirforum.com/t/versionary-elixir-plug-for-handling-api-versioning/4197/3 "2017-05-06T06:44:14Z")

</div>

Version 0.2.0 of Versionary has been released.

This release adds the ability to check for versions against media type config. This works similarly to Phoenix’s `accepts` plug.

```elixir
config :mime, :types, %{
  "application/vnd.app.v1+json" => [:v1]
}

plug Versionary.Plug.VerifyHeader, accepts: [:v1]

```

This release also adds `Versionary.Plug.PhoenixErrorHandler` for rendering a Phoenix error view when validation fails.

GitHub: [GitHub - sticksnleaves/versionary: Plug for API versioning · GitHub](https://github.com/sticksnleaves/versionary)  
Documentation: [API Reference — Versionary v0.4.1](https://hexdocs.pm/versionary/api-reference.html)  
Hex: [versionary | Hex](https://hex.pm/packages/versionary)