Camera Position Preset API reference · mansoq-teleicu-devices

Declared route and availability

This resource is declared in mansoq-teleicu-devices at /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/. plugin/local mount; actual prefix and enablement require deployment verification A registered path and an indexed handler do not prove deployment availability, user permission or production readiness.

Operation map

list · GET

GET /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/ — action list. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

response: PositionPresetReadSpec. Declared fields below; inherited fields are retained in the schema inventory.

Observed authorization checks: can_read_devices_on_location, can_read_device. Helper/queryset evidence is included; this is not proof of complete security review.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

create · POST

POST /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/ — action create. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

request: PositionPresetCreateSpec. Declared fields below; inherited fields are retained in the schema inventory.

response: PositionPresetReadSpec. Declared fields below; inherited fields are retained in the schema inventory.

The declared field table is shown at its first occurrence in this reference; this operation links the same schema.

Observed authorization checks: can_read_devices_on_location, can_read_device, can_manage_device. Helper/queryset evidence is included; this is not proof of complete security review.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

retrieve · GET

GET /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/{external_id}/ — action retrieve. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

response: PositionPresetReadSpec. Declared fields below; inherited fields are retained in the schema inventory.

The declared field table is shown at its first occurrence in this reference; this operation links the same schema.

Observed authorization checks: can_read_devices_on_location, can_read_device. Helper/queryset evidence is included; this is not proof of complete security review.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

update · PUT

PUT /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/{external_id}/ — action update. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

request: PositionPresetUpdateSpec. Declared fields below; inherited fields are retained in the schema inventory.

response: PositionPresetReadSpec. Declared fields below; inherited fields are retained in the schema inventory.

The declared field table is shown at its first occurrence in this reference; this operation links the same schema.

Observed authorization checks: can_read_devices_on_location, can_read_device, can_manage_device. Helper/queryset evidence is included; this is not proof of complete security review.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

partial_update · PATCH

PATCH /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/{external_id}/ — action partial_update. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

request: PositionPresetUpdateSpec. Declared fields below; inherited fields are retained in the schema inventory.

The declared field table is shown at its first occurrence in this reference; this operation links the same schema.

response: PositionPresetReadSpec. Declared fields below; inherited fields are retained in the schema inventory.

The declared field table is shown at its first occurrence in this reference; this operation links the same schema.

Observed authorization checks: can_read_devices_on_location, can_read_device. Helper/queryset evidence is included; this is not proof of complete security review.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

destroy · DELETE

DELETE /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/{external_id}/ — action destroy. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

Observed authorization checks: can_read_devices_on_location, can_read_device, can_manage_device. Helper/queryset evidence is included; this is not proof of complete security review.

Explicit response statuses in observed code: status.HTTP_204_NO_CONTENT. Other branches/framework exception handling may differ.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

upsert · POST

POST /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/upsert/ — action upsert. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

Observed authorization checks: can_read_devices_on_location, can_read_device, can_manage_device. Helper/queryset evidence is included; this is not proof of complete security review.

Explicit response statuses in observed code: 400. Other branches/framework exception handling may differ.

Declared refusal/error evidence: RestFrameworkValidationError: Invalid request data; RestFrameworkValidationError: No datapoints provided; RestFrameworkValidationError: Too many datapoints provided; PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

Conditional gates: conditional/computed expression; inspect pinned declaration comparison settings.MAX_DATAPOINTS_PER_UPSERT.

set_default · POST

POST /api/{installed_plugin_prefix}/{camera_external_id}/position_presets/{external_id}/set_default/ — action set_default. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

Directly observed request reads (these do not constitute a complete accepted-payload or requiredness guarantee):

Observed authorization checks: can_read_devices_on_location, can_read_device, can_manage_device. Helper/queryset evidence is included; this is not proof of complete security review.

Explicit response statuses in observed code: 200. Other branches/framework exception handling may differ.

Declared refusal/error evidence: PermissionDenied: You do not have permission to get position presets of this location; PermissionDenied: You do not have permission to update device.

Integration review checklist

Confirm the installed route and full schema; review authentication, organization/facility scoping, all accepted fields, value-state and date/time semantics, idempotency, pagination, response/exception branches and the allowed correction/reversal workflow. Test positive and negative cases with synthetic data. This source reference does not establish external certification or replace an illustrated user procedure.