Tags Endpoints

Route-level reference for MainWP REST API v2 tag endpoints, including tag CRUD, related sites/clients, and tag batch operations.

Use these endpoints to manage MainWP tags (site groups).

Use the MainWP Postman collection as the source of truth for request and response schemas.

Route Matrix

Method	Path	Purpose	Key Params
GET	/tags	List tags	page, per_page, search, include, exclude
GET	/tags/{id}	Get one tag	id
POST	/tags/add	Create a tag	name, optional color
POST, PUT, PATCH	/tags/{id}/edit	Edit a tag	name, optional color
DELETE	/tags/{id}/remove	Delete a tag	id
GET	/tags/{id}/sites	Get sites in a tag	id
GET	/tags/{id}/clients	Get clients linked through tagged sites	id
POST	/tags/batch	Batch tag create/update/delete	create[], update[], delete[]

---

Representative Requests

Create a tag

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production","color":"#7fb100"}' \
  "https://your-dashboard.com/wp-json/mainwp/v2/tags/add"

{
  "success": 1,
  "message": "Tag created successfully.",
  "data": {
    "id": 7,
    "name": "Production"
  }
}

Batch tags

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "create": [{"name":"VIP"}],
    "update": [{"id":7,"name":"Production Sites"}],
    "delete": [11]
  }' \
  "https://your-dashboard.com/wp-json/mainwp/v2/tags/batch"

{
  "create": [{"success": 1}],
  "update": [{"success": 1}],
  "delete": [{"success": 1}]
}

---

Related Resources

• REST API Overview
• Sites Endpoints
• Clients Endpoints
• Batch Endpoint