Org Content

Update a resource with PUT

PUT/org-content/resource/{id}
org-content:writeupdate_org_resource_with_putDestructiveIdempotentDeprecatedSunset 2027-06-30

Behaves exactly like PATCH /org-content/resource/{id}: it changes only the fields sent and returns the resource item, so it is not a full replacement. Deprecated: it will be withdrawn on 2027-06-30. Use PATCH /org-content/resource/{id}, which the Deprecation and Sunset headers point towards. Needs permission to manage the organisation's content. dry_run shows the result without saving it. It emits the same updated webhook event and favourite notifications as PATCH, and sending the earlier values undoes it, but not the notification.

Path parameters

  • idstring (uuid)Required#

    The item's id.

Query parameters

  • dry_runboolean#

    Validate and run the call without committing it, returning what the real call would return with meta.dry_run set.

Request body

application/json, required · OrgResourceUpdate

  • titlestring#

    The title, up to 256 characters.

  • summarystring | null#

    A short summary.

  • external_linkstring | null#

    A link to material held elsewhere, up to 2048 characters.

  • image_file_keystring | null#

    The file key of an image from POST /org-content/images.

{
  "title": "Investor handbook, updated"
}

Responses

200

The updated resource item.

OrgResource
{
  "data": {
    "id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
    "type": "resource",
    "title": "string",
    "summary": "string",
    "external_link": "string",
    "image_file_key": "string",
    "like_count": 1,
    "comment_count": 1,
    "created_at": "2026-06-12T10:00:00+00:00",
    "updated_at": "2026-06-12T10:00:00+00:00"
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl -X PUT https://your-org-domain/kong/core/api/v2/org-content/resource/{id}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"\
  -d '{
  "title": "Investor handbook, updated"
}'