> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reorder Tags

> Set the order of a field's tags

Sets the order a field's tags show in: in pickers, in pills and in Settings > Tags. Send every
tag id of the field, first to last.

```bash cURL theme={null}
curl -X PUT "https://api.clustr-ai.com/api/public/tag-groups/GROUP_ID/reorder" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag_ids": ["tag_rgxm44w3rrwqqwf93gqpzkm747", "tag_vnxk5vghcwb8nbz8ev9k5c2wkh"]}'
```

```json 200 theme={null}
{ "success": true, "data": { "reordered": true } }
```


## OpenAPI

````yaml PUT /tag-groups/{groupId}/reorder
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /tag-groups/{groupId}/reorder:
    put:
      tags:
        - Tags
      summary: Reorder Tags
      description: >
        Sets the order a field's tags appear in: in pickers, in pills and in
        Settings > Tags.

        Send every tag id of the field, first to last. Each tag takes the
        position of its id in

        the list.
      operationId: reorderTags
      parameters:
        - name: groupId
          in: path
          required: true
          description: >-
            The tag field's Clustr ID (`tgrp_…`). The id from earlier responses
            also works.
          schema:
            type: string
          example: tgrp_036x0377d1sr6k39an9zzc9k4e
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - tag_ids
              properties:
                tag_ids:
                  type: array
                  description: >-
                    The Clustr IDs (`tag_…`) of every tag in the field, in the
                    new order. The ids from earlier

                    responses also work.
                  items:
                    type: string
                  example:
                    - tag_jdt6kxr7919byqqxb1ef6mm7df
                    - tag_hcdskcfyn64gp1p9ext6fedray
      responses:
        '200':
          description: The new order is saved
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      reordered:
                        type: boolean
                        example: true
        '400':
          description: >-
            `groupId` is not a valid id, or `tag_ids` is missing or holds a
            value that is not a tag id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Invalid or missing API key
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            message:
              type: string
              example: Invalid request body
            code:
              type: string
              example: BAD_REQUEST
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.