Tags

Show

You can view the tags assigned to a specific server or retrieve all tags across multiple servers using the respective APIs.

• Fetch Tags for a Specific Server: To retrieve the tags associated with a specific server, use the API.

• Fetch Tags for All Servers: To get a complete list of servers along with their assigned tags, use the API.

Update

Update the tags associated with a specific server for better categorization and management.

HTTP Request:

PATCH https://api.serveravatar.com/organizations/{organization}/servers/{server}/tags

Curl Request Example:

curl --request PATCH \
  --url "https://api.serveravatar.com/organizations/{organization}/servers/{server}/tags" \
  --header 'content-type: application/json' \
  --header 'Authorization: <YOUR API TOKEN>' \
  --data '{
      "tags": ["Tag1", "Tag2", "Tag3"]
  }'

Response:

Tags Update

• 200 (Ok)

{
  "message": "Tags updated successfully."
}

Organization Not Found

• 404 (Not found)

{
    "message": "Organization not found."
}

Server Not Found

• 404 (Not Found)

{
    "message": "Server not found."
}

Server Error

• 500 (Internal Server Error)

{
    "message": "Something went wrong."
}

Delete

Delete all tags associated with a specific server.

HTTP Request:

DELETE https://api.serveravatar.com/organizations/{organization}/servers/{server}/tags

Curl Request example:

curl --request DELETE \
  --url "https://api.serveravatar.com/organizations/{organization}/servers/{server}/tags" \
  --header 'content-type: application/json' \
  --header 'Authorization: <YOUR API TOKEN>'

Response:

Tags Delete

• 200 (Ok)

{
  "message": "Tags removed successfully."
}

Organization Not Found

• 404 (Not found)

{
    "message": "Organization not found."
}

Server Not Found

• 404 (Not Found)

{
    "message": "Server not found."
}

Server Error

• 500 (Internal Server Error)

{
    "message": "Something went wrong."
}