Overview
PUT/communities/{id}/categories/{catId}community

Edit a category (community admin only)

Replace a record in categories by id, catId.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • idpathstring
  • catIdpathstring
Request body

application/json · optional

  • slugoptionalstring
  • nameoptionalstring
  • descriptionoptionalstring
  • coloroptionalstring
  • displayOrderoptionalinteger
  • isPublicoptionalboolean
  • isArchivedoptionalboolean

    true archives (the admin "delete") — hidden from every list, discussions retained.

Example
{
  "slug": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "displayOrder": 0,
  "isPublic": true,
  "isArchived": true
}
Responses
200

The updated category

  • idstring
  • communityIdstring
  • slugstring
  • namestring
  • descriptionoptionalstring?
  • coloroptionalstring?
  • displayOrderinteger
  • isPublicboolean
  • isArchivedboolean
  • createdAtstring
  • updatedAtstring
  • discussionCountoptionalinteger

    Live discussions filed under this category (public-only for anonymous callers).

  • lastActivityAtoptionalstring?

    Most recent activity across the category’s live discussions (null when empty).

Example
{
  "id": "string",
  "communityId": "string",
  "slug": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "displayOrder": 0,
  "isPublic": true,
  "isArchived": true,
  "createdAt": "string",
  "updatedAt": "string",
  "discussionCount": 0,
  "lastActivityAt": "string"
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
403

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
409

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X PUT "https://api.agenticdeveloperhub.com/communities/{id}/categories/{catId}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "slug": "string",
  "name": "string",
  "description": "string",
  "color": "string",
  "displayOrder": 0,
  "isPublic": true,
  "isArchived": true
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/communities/{id}/categories/{catId}", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"slug\": \"string\",\n  \"name\": \"string\",\n  \"description\": \"string\",\n  \"color\": \"string\",\n  \"displayOrder\": 0,\n  \"isPublic\": true,\n  \"isArchived\": true\n}",
});
const data = await res.json();