EVeve
v1

Publicv1Callsrouter.Begin Upload

put/v1/calls/{external_call_id}/begin-upload

Request

  • Base URL
    https://app.eve.legal (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: token

Path parameters

external_call_idstring required

Request body

fileNamestring required

Audio file name (.mp3, .wav, .ogg)

startedAtstring date-time required

ISO 8601 timestamp for when the call started

endedAtstring date-time required

ISO 8601 timestamp for when the call ended

direction'INBOUND' | 'OUTBOUND' required
fromNumberstring required

Caller phone number (E.164)

toNumberstring nullable

Callee phone number (E.164)

operatorNamestring nullable

Name of the operator on the call

operatorEmailstring email nullable

Email of the operator on the call

operatorIdstring nullable

Provider's internal identifier for the operator

externalMatterIdstring nullable

External ID of the matter to assign the call to. Mutually exclusive with external_lead_id. If you omit both IDs, Eve matches the call to a recent matter or lead by phone number. A retry with a different ID moves the call, also after confirm-upload. A retry without an ID keeps the current assignment.

externalLeadIdstring nullable

External ID of the lead to assign the call to. Mutually exclusive with external_matter_id.

Response

Successful Response

signedUploadUrlstring nullable

Presigned S3 URL for uploading the audio file via HTTP PUT. The URL expires after a short period; call this endpoint again to get a fresh URL. Null once the call has been confirmed and is processing or completed.

Changes

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