Get a TODO

get

Get a specific todo for an agent.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

todoIdstringRequired

Responses

200

Successful Response

application/json

idstringOptional

typestring · enumOptionalPossible values:

titlestringOptional

descriptionstring · nullableOptional

statusstring · enumOptionalPossible values:

prioritystring · enum · nullableOptionalPossible values:

dueDatestring · date-time · nullableOptional

metadataobject · nullableOptional

opportunityIdstringOptional

pipelineIdstringOptional

stageIdstringOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/agents/{agentId}/todos/{todoId}

HTTPcURLJavaScriptPython

GET /v1/agents/{agentId}/todos/{todoId} HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": "text",
  "type": "opportunity",
  "title": "text",
  "description": "text",
  "status": "pending",
  "priority": "low",
  "createdBy": {
    "uid": "text",
    "displayName": "text",
    "email": "text"
  },
  "updatedBy": {
    "uid": "text",
    "displayName": "text",
    "email": "text"
  },
  "assignedTo": {
    "uid": "text",
    "displayName": "text",
    "firstName": "text",
    "lastName": "text",
    "alias": "text",
    "role": "agent",
    "email": "text",
    "photoURL": "text",
    "phoneNumber": "text"
  },
  "dueDate": "2026-04-02T08:21:20.040Z",
  "metadata": {},
  "opportunityId": "text",
  "pipelineId": "text",
  "stageId": "text",
  "createdAt": "2026-04-02T08:21:20.040Z",
  "updatedAt": "2026-04-02T08:21:20.040Z"
}