Tags

Free-form labels you can attach to domains or mailboxes to organize them — by client, campaign, sending pool, or anything else useful in your own workflow.

Method	Path	Description
`GET`	`/v1/api/tags`	List all tags in the workspace
`POST`	`/v1/api/tags`	Create a new tag
`DELETE`	`/v1/api/tags/{uid}`	Delete a tag
`POST`	`/v1/api/tags/assign`	Assign tag(s) to domain(s) or mailbox(es)

Create and assign a tag


curl -X POST https://api.infrabox.software/v1/api/tags \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{ "name": "client-acme" }'


curl -X POST https://api.infrabox.software/v1/api/tags/assign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{ "tag_uids": ["tag_123"], "mailbox_uids": ["mb_111", "mb_222"] }'

Errors

Status	Meaning
`400`	Invalid body
`401`	Missing/invalid API key
`404`	Tag, domain, or mailbox not found
`500`	Internal error