# Set hold until date via api

**URL:** <https://community.shiphero.com/t/set-hold-until-date-via-api/1347>\
**Category:** GraphQL API\
**Created:** [June 1, 2021, 2:49pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347 "2021-06-01T14:49:33Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Csraspini](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/csraspini/32/125_2.png) [@Csraspini](https://community.shiphero.com/u/Csraspini)\
**Post date:** [June 1, 2021, 2:49pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347/1 "2021-06-01T14:49:33Z")

</div>

Hi there, is it possible to set a hold until date via api?  
Thanks,  
Claudia

---

<div class="post-metadata">

**Author:** ![Theresa](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/theresa/32/377_2.png) [@Theresa](https://community.shiphero.com/u/Theresa)\
**Post date:** [June 1, 2021, 5:51pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347/2 "2021-06-01T17:51:49Z")

</div>

Hi @Csraspini🙂  
Yes, that setting is available on the order level. For instance, if you were updating the order:

```
mutation {
  order_update(
    data: {
      order_id: "[order id here]"
      hold_until_date: "[hold until date here]"
    }
  ) {
    request_id
    complexity
    order {
      hold_until_date
    }
  }
}

```

The date is a string  
ISODateTime

A DateTime field type that understand ISO 8601 strings, besides datetime objects. It supports strings with and without times, as well as using T or space as delimiter

Ex.

- YYYY-mm-dd
- YYYY-mm-dd HH:MM:SS
- YYYY-mm-ddTHH:MM:SS

---

<div class="post-metadata">

**Author:** ![Csraspini](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/csraspini/32/125_2.png) [@Csraspini](https://community.shiphero.com/u/Csraspini)\
**Post date:** [June 4, 2021, 2:21pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347/3 "2021-06-04T14:21:09Z")

</div>

thank you! that’s just what i needed!

---

<div class="post-metadata">

**Author:** ![Csraspini](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/csraspini/32/125_2.png) [@Csraspini](https://community.shiphero.com/u/Csraspini)\
**Post date:** [June 6, 2021, 1:44pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347/4 "2021-06-06T13:44:52Z")

</div>

Sorry Theresa, one more question about this:  
what if I want to unset it, for some reason?

---

<div class="post-metadata">

**Author:** ![Theresa](https://sea2.discourse-cdn.com/flex020/user_avatar/community.shiphero.com/theresa/32/377_2.png) [@Theresa](https://community.shiphero.com/u/Theresa)\
**Post date:** [June 7, 2021, 3:48pm UTC](https://community.shiphero.com/t/set-hold-until-date-via-api/1347/5 "2021-06-07T15:48:08Z")

</div>

Hi! I cannot find a way to set it back to empty, because it needs to be a specific date format to avoid errors. Could you not just set it to a date that has passed?