Search for Reminders

Search for reminders

post

Authorizations

BearerAuthApiKeyAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

agentIdstringRequired

Body

application/json

Responses

200

Reminders found

application/json

This an object representing a reminder.

idstringRequired

purposestringRequired

contextstringOptional

timestampnumberRequired

When the reminder is due

statusstring · enumRequiredPossible values:

metadataobjectOptional

taskIdstringRequired

customerIdstring · nullableOptional

opportunityIdstring · nullableOptional

createdAtstring · date-timeRequired

When the reminder was created

updatedAtstring · date-timeRequired

When the reminder was last updated

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

post

/v1/agents/{agentId}/reminders/search

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/reminders/search HTTP/1.1
Host: api.voxity.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94

{
  "filters": {
    "status": [
      "pending"
    ],
    "purpose": "text",
    "customerId": "text",
    "opportunityId": "text"
  }
}

[
  {
    "id": "text",
    "purpose": "text",
    "context": "text",
    "timestamp": 1,
    "status": "pending",
    "metadata": {},
    "taskId": "text",
    "customerId": "text",
    "opportunityId": "text",
    "createdAt": "2026-04-04T08:03:41.425Z",
    "updatedAt": "2026-04-04T08:03:41.425Z"
  }
]