Resources

Update a resource

curl -X PATCH https://api.subscriby.net/v1/projects/$PROJECT_ID/resources/$RESOURCE_ID \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Members lounge (VIP)" }'

Partial by design: only the fields present in the body change, so a title-only update leaves the description exactly as stored, filtered HTML included, and logs no description edit. kind and space are not writable here: a resource keeps its kind for life, and its place moves only through the connector.

Answers 200 with the resource. When at least one field actually changed, project.resource.updated fires once with a changes map of {field: {from, to}}; a body that restates the stored values writes nothing and emits nothing.

patch/v1/projects/{project}/resources/{resource}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/resources/{resource}
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

resourcestring uuid required

The resource, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Request body

titlestring

The resource's name on plan cards, 5 to 255 characters.

descriptionstring nullable

What the resource is, up to 1,000 characters, the same HTML filter as create; null clears it.

activeboolean

Whether plans grant it; the activate and deactivate endpoints flip the same switch.

Response

The resource after the change.

Example response

{
  "data": {
    "id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "kind": "telegram:channel",
    "connector": "telegram",
    "space": {
      "id": "3c1f7a58-2b6e-4d90-8f41-6a2e9c5d7b10",
      "external_id": "-1001234567890",
      "title": "Research Premium Lounge"
    },
    "title": "Research Premium Lounge",
    "description": "Daily research notes and the members-only Q&A.",
    "active": true,
    "created_at": "2026-05-18T10:05:00Z",
    "updated_at": "2026-05-18T10:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.