Skip to main content
POST
Respond to action request

Authorizations

Authorization
string
header
required

API key authentication. Use format: Authorization: Bearer tavrn_sk_live_...

Path Parameters

retrieval_request_id
string
required

Retrieval request ID

Body

application/json
message
string
required

Your answer to the action request. Leading and trailing whitespace is trimmed; must not be empty.

Required string length: 1 - 10000
Example:

"Approved. Please pay the $85.00 invoice."

requester_email
string<email>

Email of the person at your firm who answered. Recorded as the responder; defaults to the API key.

Example:

"paralegal@yourfirm.com"

attachment
object

A file to send with the response, uploaded under the retrieval request's case.

Response

Response recorded

id
string
required

ID of the action request that was answered (matches pending_action_request.id)

Example:

"car_abc123"

retrieval_request_id
string
required
Example:

"rr_abc123"

status
enum<string>
required
Available options:
responded
Example:

"responded"

responded_at
string<date-time>
required
Example:

"2025-02-03T16:05:00Z"