Skip to main content
  1. Home
  2. Resources
  3. Developers
  4. API Developers Forum

When is it safe to delete list after invoking add tag endpoint?

Andrew McLean By 
October 07, 2016

I want to add/delete a bunch of tags from a bunch of people. This involves multiple sequences along the lines

  • Create temporary list
  • Add people to list
  • Add tags to people in list / remove tags from people in list
  • Delete list

The documentation for the add tag endpoint says:

Use this endpoint to apply a tag to the people contained in a list. Note: this endpoint returns a HTTP 204 status code, but the tag is not applied immediately. For larger lists, this operation takes many minutes.

The remove tags endpoint is similar. So when is it safe to delete the list?

Official response from

Andrew,

Once your done with adding/removing tags from those people you can delete the list. Deleting the list does not delete the people on that list (http://apiexplorer.nationbuilder.com/nationbuilder#Lists) when you hit the /api/v1/lists/:list ID endpoint.

Share this post

Showing 2 reactions

How would you tag this suggestion?

Sign in with

Please check your e-mail for a link to activate your account.
  • Andrew McLean
    commented
    The endpoint to add or delete tags from a list of individuals initiates the process and is non-blocking. The API documentation says it can take many minutes. I believe that if I delete the list before the addition or deletion of tags has completed, that it will not complete, but there doesn’t seem to be any way to tell when the process is complete and thus when it is safe to delete the list.
    posted 2016-10-17 16:19:17 -0700
  • Farz Sokhansanj
    NationBuilder employee
    responded with completed
    posted 2016-10-17 15:54:52 -0700