# Documentation Development

**URL:** https://developer-forum.veeqo.com/t/documentation-development/51
**Category:** API Queries (How To)
**Created:** [August 14, 2017, 10:23am UTC](https://developer-forum.veeqo.com/t/documentation-development/51 "2017-08-14T10:23:18Z")
**Posts on this page:** 12
**Page:** 1

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [August 14, 2017, 10:23am UTC](https://developer-forum.veeqo.com/t/documentation-development/51/1 "2017-08-14T10:23:18Z")

</div>

I’m going to be gradually updating our documentation over the coming weeks and months. As you can imagine, its not a little project so it make take me a little while to get it perfect but it will get there!

If there is anything you want want to see specifically, then let me know below and I’ll try and prioritise that.

I’m also going to use this thread to post any updates as they happen. You can also see the log of any commits on the [GitHub](https://github.com/VeeqoAPI/)

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [August 14, 2017, 10:24am UTC](https://developer-forum.veeqo.com/t/documentation-development/51/2 "2017-08-14T10:24:37Z")

</div>

Added JSON responses to _/orders_ and _/orders/ID_.  
_Order Notes_ has been merged into _Orders_.  
Small updates to _Orders_ and _Customers_.  
_ReadMe_ updated for the GitHub.

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [August 15, 2017, 4:04pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/3 "2017-08-15T16:04:12Z")

</div>

There’s been a pretty big update to the documentation for the “_/orders_” end point today.

It’s not finished yet and I’ve pushed it live sooner than I normally would at the request of Sapient so it hasn’t had the usual thorough testing and review that updates normally get.

I will hopefully update it again tomorrow.

If you read this and then spot anything please drop a reply below and I’ll make sure it gets corrected!

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [September 25, 2017, 11:15am UTC](https://developer-forum.veeqo.com/t/documentation-development/51/4 "2017-09-25T11:15:30Z")

</div>

Updated _Orders_ documentation again.

`/orders/:id` has been updated to with usage examples.

Also small update to _channels_.

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [September 29, 2017, 12:15pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/5 "2017-09-29T12:15:27Z")

</div>

Updated _Products_ Documentation

`/products` and `/products/:id` now have full responses.

Are there any thoughts on the styling of the responses for these vs the styling of the response for _Create New Product_?

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [October 16, 2017, 3:47pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/6 "2017-10-16T15:47:35Z")

</div>

There’s been a few back end updates to the API docs lately. If anyone actually looks at the source on GitHub then many of the JSON requests and responses have begun making their way into their own files. The main reason for this is it makes maintaining the documentation loads easier!

The other notable change of late is that some of the more useful response headers have been documented. If you want to know the total number of orders that have been returned (before the pagination kicks in) then you just have to look at the `X-Total-Count` response header. All now in the docs as well.

---

<div class="post-metadata">

### Author: ![Andriy](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/andriy/32/28_2.png) [@Andriy](https://developer-forum.veeqo.com/u/Andriy)
#### Post date: [October 18, 2017, 4:29pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/7 "2017-10-18T16:29:42Z")

</div>

Hello, Phil

Just saw you have one extra undocumented feature:

Assign tag to order.

That would be great, if you describe it in your documentation:

Endpoint:

`post https://app.veeqo.com/bulk_tagging/`

Params:

`order_ids: [order_ids], tag_ids: [tag_ids]`

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [October 19, 2017, 11:58am UTC](https://developer-forum.veeqo.com/t/documentation-development/51/8 "2017-10-19T11:58:34Z")

</div>

`/bulk_tagging` end point is now in the documentation.

I’ve also added a section about GET requests to the `/stock_entries` end point and updated various bits of `/allocations`

Let me know if you find any bugs, or if you want anything else adding! Thanks!

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [December 7, 2017, 1:50pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/9 "2017-12-07T13:50:11Z")

</div>

I’ve just updated the /orders endpoint with a couple of corrections including the addition of `number`  
The order `number` field is normally used to store the ID of the order from the channel.

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [January 19, 2018, 9:59pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/10 "2018-01-19T21:59:45Z")

</div>

Couple of big updates to the documentation for /orders endpoint.  
Order response has been updated and more importantly there are 4 new examples of the create order POST request.  
The attributes are a bit behind the examples now but the examples should help answer a lot of common queries. Check it out and let me know if you have any more queries or spot any mistakes: [https://developer.veeqo.com/docs#/reference/orders/order-collection/create-a-new-order](https://developer.veeqo.com/docs#/reference/orders/order-collection/create-a-new-order)

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [February 14, 2018, 10:28am UTC](https://developer-forum.veeqo.com/t/documentation-development/51/11 "2018-02-14T10:28:08Z")

</div>

We’ve just added notes to the customer object. You can now store a short string with extra information about the customer.

Customer POST request can now look like:

```
{
  "customer": {
    "email": "Phil+API@veeqo.com",
    "phone": "01792 720740",
    "mobile": "07329023903",
    "notes": "This person buys things",
    "billing_address_attributes": {
      "first_name": "Phil",
      "last_name": "Reynolds",
      "company": "Veeqo Ltd",
      "address1": "Tech Hub",
      "address2": "221 High Street",
      "city": "Swansea",
      "country": "GB",
      "zip": "SA1 1NW"
    }
  }
}

```

View the [docs here.](https://developer.veeqo.com/docs#/reference/customers/customer-collection/create-a-customer)

---

<div class="post-metadata">

### Author: ![phil](https://yyz1.discourse-cdn.com/flex033/user_avatar/developer-forum.veeqo.com/phil/32/43_2.png) [@phil](https://developer-forum.veeqo.com/u/phil)
#### Post date: [March 5, 2018, 4:40pm UTC](https://developer-forum.veeqo.com/t/documentation-development/51/12 "2018-03-05T16:40:34Z")

</div>

Updated the introduction of the Docs today to hopefully make it a bit more helpful for first time users.

Also updated the /channels end point with better responses.
