generated: '2026-07-27' method: generated source: openapi/virtual-peaker-gravity-connect-device-partner-api-openapi.yml, openapi/virtual-peaker-gravity-connect-vpp-api-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 23 by_action_class: connected: 8 acting: 15 by_consequence: read: 8 write: 14 physical: 1 human_in_the_loop_required: 0 operations: - path: /device/{DEVICE_UID} method: get operationId: readDeviceDetails x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /device/{DEVICE_UID}/{SIGNAL_OR_SETTING}/{DATA_KEY} method: put operationId: updateSignalSetting x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /device/{DEVICE_UID}/{SIGNAL_OR_SETTING}/{DATA_KEY} method: get operationId: readSignalSetting x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /device/{DEVICE_UID}/user method: get operationId: readDeviceUser x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /houses method: post operationId: publishHouseList x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /command method: post operationId: sendCommand x-agentic-access: action-class: acting consequence: physical subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /command/{COMMAND_REFERENCE_ID} method: get operationId: readCommandState x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /command/{COMMAND_REFERENCE_ID} method: delete operationId: cancelCommand x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /subscription method: post operationId: modifySubscription x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /group method: post operationId: createGroup x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /group/{GROUP_ID} method: get operationId: readGroup x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /group/{GROUP_ID} method: put operationId: updateGroup x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /group/{GROUP_ID} method: delete operationId: deleteGroup x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /group/{GROUP_ID}/devices method: post operationId: manageGroupDevices x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /command/{COMMAND_REFERENCE_ID}/opt-out method: post operationId: commandOptOut x-agentic-access: action-class: acting consequence: write subject: required scope: - basic_partner_read_write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /devices method: get operationId: readCurrentUserDevices x-agentic-access: action-class: connected consequence: read subject: optional scope: - user_read token: max-ttl: 3600 audit: none - path: /user method: get operationId: readCurrentUser x-agentic-access: action-class: connected consequence: read subject: optional scope: - user_read token: max-ttl: 3600 audit: none - path: /device/{DEVICE_UID}/energy method: get operationId: readDeviceEnergyInterval x-agentic-access: action-class: connected consequence: read subject: optional scope: - basic_partner_read_write token: max-ttl: 3600 audit: none - path: /publish/{PROGRAM_PUBLISH_KEY}/update method: post operationId: publishSignalSetting x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /publish/{PROGRAM_PUBLISH_KEY}/command method: post operationId: publishCommand x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /publish/{PROGRAM_PUBLISH_KEY}/command/device method: post operationId: publishDeviceCommand x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /publish/{PROGRAM_PUBLISH_KEY}/device method: post operationId: publishDeviceEnrollment x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /publish/{PROGRAM_PUBLISH_KEY}/enrollment method: post operationId: publishDevicePartnerDrivenEnrollment x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required