{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To enable or disable telemetry signals for a resource, send a PUT request to\n`/v2/insights/resources/{resource_urn}/signals`.\n\nThis endpoint uses merge semantics. Set `metrics`, `logs`, or `traces` to\n`true` or `false` to change that signal; omit a signal to leave it unchanged.\nAt least one signal must be set.\n\n`region` is only used when the resource has no existing enablement. On later\nupdates, omit it or send the stored value; changing the region is rejected\nwith a `400`.\n\nRequires both the `insights:update` and `insights:create` scopes.\n","properties":{"path":{"type":"object","properties":{"resource_urn":{"type":"string","examples":["do:droplet:12345"],"description":"The uniform resource name (URN) of the resource, for example `do:droplet:12345`."}},"required":["resource_urn"],"additionalProperties":false},"body":{"$ref":"#/definitions/resource_signals_update_request","examples":[{"region":"nyc3","metrics":true,"logs":true}]}},"required":["path","body"],"additionalProperties":false,"definitions":{"resource_signals_update_request":{"type":"object","description":"Request body for updating a resource's signal enablement. At least one of `metrics`, `logs`, or `traces` must be set. Signals that are omitted are left unchanged.","properties":{"region":{"type":"string","description":"The region slug for region-specific resources. Only used when the resource has no existing enablement. On later updates, omit it or send the stored value; changing the region is rejected.","examples":["nyc3"]},"metrics":{"type":"boolean","description":"Enable or disable the metrics signal. Omit to leave unchanged.","examples":[true]},"logs":{"type":"boolean","description":"Enable or disable the logs signal. Omit to leave unchanged.","examples":[true]},"traces":{"type":"boolean","description":"Enable or disable the traces signal. Omit to leave unchanged.","examples":[false]}}}}},"name":"Update Resource Signal Enablement","id":"digitalocean.insights_update_resourcesignals","example":{"path":{"resource_urn":"do:droplet:12345"},"body":{}},"maxRequests":1,"summary":false}}