Telephony

Register document upload metadata

Finalizes a previously granted upload. The immutable object generation, ownership path, signed metadata, byte length, SHA-256, and actual file signature are verified before a bounded malware scan runs. Extraction remains blocked unless the terminal scan result is clean.

post/v1/telephony/compliance-cases/{id}/uploads

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/v1/telephony/compliance-cases/{id}/uploads
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Request body

document_request_idstring required
object_refstring required

Opaque object-storage reference. Never a document body or public URL.

file_namestring required
generationstring

Optional immutable object generation returned by storage.

mime_typestring required
size_bytesinteger required
sha256string required

Lowercase SHA-256 content hash.

Response

Upload metadata registered

idstring required
object'telephony.compliance_case' required
project_idstring required
kind'new_number' | 'port_in' required
country'US' | 'CA' | 'IN' | 'GB' | 'AU' required
number_typestring
capabilitiesstring[]
use_casestring
network_statusstring
state'collecting_evidence' | 'extracting' | 'needs_review' | 'ready_for_submission' | 'submitted' | 'cancelled' required
continuation_reasonstring nullable
terminal_reason'network_review_submitted' | 'cancelled_by_customer' | 'null' nullable
correctionsobject[]

Correction audit metadata. Corrected PII values are intentionally omitted from API views.

matchesobject[]
attestationsobject[]
timelineobject[] required
created_atinteger
updated_atinteger
retention_delete_atinteger
versioninteger required

Example response

{
  "id": "ncc_..."
}

Changes

No recorded changes to this operation across all 1 revision of this API.