Tags
GET /api/orgs/{org_id}/tags
Section titled “GET /api/orgs/{org_id}/tags”List Tags
List all tags in the org registry, ordered by name.
Omit limit to get every tag; total is the full count either way.
Auth: org member.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | no | Max rows to return (1-100). Omit to return every row. |
| offset | query | integer | no | Rows to skip — pass the previous response’s next_offset. |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | Page_TagRead_ |
| 422 | Validation Error | HTTPValidationError |
POST /api/orgs/{org_id}/tags
Section titled “POST /api/orgs/{org_id}/tags”Create Tag
Create a new tag in the org registry.
The name is normalized (lowercased, trimmed) before storage. If a tag with the resulting name already exists, the existing tag is returned (idempotent).
Auth: org admin/owner.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| color | string | no | Optional color hex/name. |
| description | string | no | Optional human-readable description. |
| name | string | yes | Tag name. Will be normalized (lowercased, trimmed). |
Responses
| Status | Description | Body |
|---|---|---|
| 201 | Successful Response | TagRead |
| 422 | Validation Error | HTTPValidationError |
PATCH /api/orgs/{org_id}/tags/{tag_id}
Section titled “PATCH /api/orgs/{org_id}/tags/{tag_id}”Update Tag
Update a tag’s name, color, or description.
Only fields present in the request body are applied.
Pass null to clear color or description.
Auth: org admin/owner.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| tag_id | path | string (uuid) | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| color | string | no | |
| description | string | no | |
| name | string | no |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | TagRead |
| 422 | Validation Error | HTTPValidationError |
DELETE /api/orgs/{org_id}/tags/{tag_id}
Section titled “DELETE /api/orgs/{org_id}/tags/{tag_id}”Delete Tag
Soft-delete a tag from the registry.
Also removes all entity-tag associations for this tag.
Auth: org admin/owner.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| tag_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 204 | Successful Response | |
| 422 | Validation Error | HTTPValidationError |