GET https://api.orbitkit.com/tags/en

Gets a list of all your tags, in order. The response looks like:

{
    "tags": ["tag1", "tag2", "tag3", "tag4", "tag5"]
}

POST https://api.orbitkit.com/tags/en

Tag order is global to your Organization and affects all designs. You can control tag order by posting to this method. Put the language (en, fr, es, de) in the URL and submit a body that looks like this:

{
    "tags": [
        ["tag1", "tag2", "tag3"],
        ["tag3", "tag4", "tag5"],
        // as many tag groups as you want; OrbitKit will figure out order
    ]
}

Only tags that you specify will be reordered, and only relative to the other tags you specify. 

Note that tags is an array of arrays. Typically you would submit the list of tags for each design; OrbitKit will figure out a simple coherent order by doing a topological sort. There is no requirement to do it this way; you can submit just one giant array, but be sure to preserve the above expected array-of-arrays structure.

This method works whether or not tags are currently in use by a design. If you are using the /designs API to import designs, you will probably want to use this method to submit the order of your tags; this can be done before or after you import the designs.

The response will be a flattened array of *all* your tags (even ones you did not specify), in order:

{
    "tags": ["tag1", "tag2", "tag3", "tag4", "tag5"]
}

Did this answer your question?