Skip to main content
PUT
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
tags
/
{id}
Update Tag
curl --request PUT \
  --url https://api.example.com/v1/organizations/{organizationId}/projects/{projectId}/tags/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'

Path Parameters

organizationId
string
required
Organization ID
projectId
string
required
Project ID
id
string
required
Tag ID

Request Body

name
string
Updated display name (slug will be regenerated)
description
string
Updated description

Example Request

{
  "description": "Updated description for technology content"
}

Response

Returns the updated Tag object.
{
  "id": "tag123",
  "name": "Technology",
  "slug": "technology",
  "description": "Updated description for technology content",
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-22T10:00:00Z"
}

Error Responses

Tag Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Tag not found"
  }
}

Tag Name Already Exists

{
  "error": {
    "code": "TAG_NAME_EXISTS",
    "message": "A tag with this name already exists"
  }
}

Code Examples

curl -X PUT "https://api.metabind.ai/v1/organizations/org123/projects/proj456/tags/tag123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description"
  }'