DealerAI
API Reference

List predefined assistant tasks

Returns the catalog of predefined assistant tasks available to your account, including each task key and the parameters it accepts. Use a task key with the execute endpoint to run it.

GET
/api/v1/assistant/predefined-tasks

Authorization

basic
AuthorizationBasic <token>

Basic Authorization header

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://api.dealerai.com/api/v1/assistant/predefined-tasks"
[
  {
    "task_key": "string",
    "title": "string",
    "description": "string"
  }
]
{
  "message": "string",
  "details": null
}
{
  "message": "string",
  "details": null
}

List appointments

Returns a paginated list of appointments booked through the assistant. Supports filtering by dealership, appointment type, free-text query, and date range, with an optional AI-generated summary per appointment.

Execute a predefined assistant task

Runs the predefined assistant task identified by taskKey using the parameters supplied in the request body, and returns the task result. Use the predefined-tasks list endpoint to discover valid task keys and their expected parameters.