---
title: "Update collector (partial)"
method: PATCH
path: "/collectors/{key}"
tags: ["collectors"]
---

# Update collector (partial)

`PATCH /collectors/{key}`

Update the specified collector's config data. If a field is not included in the querybody, that field will not be updated.

## Path parameters

- `key` string, required

## Request body

- object — Fields permitted for patching.
  - `collectorGroup` string — Name of the collectorGroup this collector belongs to.
  - `description` string — Describes this Collector; helps a user determine which Collectors they should assign to run their collection.
  - `helpEmail` string — The email address where a user can go to get more help about the collector.
  - `helpUrl` string — The url where a user can go to get more help about the collector.
  - `host` string — Access restricted to Refocus Collector only.
  - `ipAddress` string — Access restricted to Refocus Collector only.
  - `osInfo` object — Access restricted to Refocus Collector only.
  - `processInfo` object — Access restricted to Refocus Collector only.
  - `version` string — Access restricted to Refocus Collector only.
  - `owner` string — The name of the user to assign as the owner. Defaults to the user that created it

## Other responses

- `403` — Forbidden
- `404` — Resource Not Found

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)