Skip to content

Rejected e-mails

API reference

E-mails the classifier did not treat as purchase orders. Guide: Rejected e-mails.

List rejected e-mails

GET/rejected/listintegration key

E-mails the classifier did not treat as purchase orders, newest first. status=pending (default) lists the ones still awaiting a decision; status=overridden those already reprocessed.

Parameters

NameInTypeRequiredDescription
pagequeryintegerPage number Default 1. Min 1.
sizequeryintegerItems per page Default 100. Min 1. Max 1000.
statusquerystringRejection-triage status filter Default pending.

Responses

StatusDescriptionBody
200Successful ResponseRejectedEmailListResponse
404Resource not foundErrorResponse
422Validation ErrorHTTPValidationError
bash
curl -X GET "https://acme.aiotic.ai/rejected/list?page=1&size=100&status=pending" -H "X-API-Key: $AIOTIC_API_KEY"
python
client.rejected.list(status="pending").items

Get one rejected e-mail

GET/rejected/{request_id}integration key

Get a single rejected (non-purchase-order) classified email by request ID.

This is the rejected-email detail endpoint, not a generic classified-email lookup: a purchase_order row is reported as 404 (it does not belong to this surface).

Parameters

NameInTypeRequiredDescription
request_idpathstringyesThe order's id (UUID) as returned by the upload endpoints

Responses

StatusDescriptionBody
200Successful ResponseClassifiedEmail
404Resource not foundErrorResponse
422Validation ErrorHTTPValidationError
bash
curl -X GET "https://acme.aiotic.ai/rejected/<request_id>" -H "X-API-Key: $AIOTIC_API_KEY"
python
client.rejected.get(request_id)

Reprocess a rejected e-mail as a purchase order

POST/rejected/{request_id}/reprocessintegration key

Overrides the classifier for one e-mail and runs it through normal processing under the same request_id. The original classification is preserved for audit.

Parameters

NameInTypeRequiredDescription
request_idpathstringyesThe order's id (UUID) as returned by the upload endpoints

Responses

StatusDescriptionBody
200Successful ResponseReprocessResponse
404Resource not foundErrorResponse
422Validation ErrorHTTPValidationError
bash
curl -X POST "https://acme.aiotic.ai/rejected/<request_id>/reprocess" -H "X-API-Key: $AIOTIC_API_KEY"
python
client.rejected.reprocess(request_id)            # then poll client.orders.get(request_id)

Documentation revision 3 · Published 8 September 2026 · commit 6862d5e. Verified against AIOTIC API v1.0.0. AIOTIC is a product of DevOps Company.