Orphan Chat API reference · mansoq-ayushma

Declared route and availability

This resource is declared in mansoq-ayushma at /api/{installed_plugin_prefix}/chats. 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}/chats — action list. static contract extracted; runtime/permission/payload behavior review pending.

Path and deployment-context parameters:

serializer: ChatDetailSerializer. Declared fields below; inherited fields are retained in the schema inventory.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

create · POST

POST /api/{installed_plugin_prefix}/chats — 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):

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

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

retrieve · GET

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

Path and deployment-context parameters:

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

partial_update · PATCH

PATCH /api/{installed_plugin_prefix}/chats/{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):

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

converse · POST

POST /api/{installed_plugin_prefix}/chats/{external_id}/converse — action converse. 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):

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

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

transcribe · POST

POST /api/{installed_plugin_prefix}/chats/transcribe — action transcribe. 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):

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

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

Declared refusal/error evidence: ValidationError: audio and engine are required.

completion · POST

POST /api/{installed_plugin_prefix}/chats/completion — action completion. 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):

serializer: ChatDetailSerializer. 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.

Authorization: no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.

Class policy declarations: permission_classes: APIKeyAuth.

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

Declared refusal/error evidence: ValidationError: task is required; ValidationError: Invalid task; ValidationError: audio and engine are required.

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.