Actions

List action executions

Use to find conversations by executed availability, pricing, checkout, booking, custom HTTP/collection or Sheets actions, or investigate activity in one conversation. Omit conversationId for business-wide discovery; filter by actionId and explicit from/to, paginate and deduplicate returned conversationIds. Use get_conversation for matched contacts/metadata and get_action_execution for saved inputs/results. For recent chats with projected action history use list_conversations with actionId; read messages only when requested content or attempts without a recorded action are needed. Use list_conversation_handoffs for human escalation history. Requires action_executions:read. Returns up to 30 saved execution receipts, newest first, ordered by start time then identity. Repeat filters with nextCursor; default seven-day date boundaries remain fixed for pagination. A supplied conversationId must belong to the credential tenant (404 otherwise). Use each entry.receiptId as executionId for detail. Parameters and saved responses never appear here. History covers saved supported gateway executions without historical reconstruction; older, unsupported and background-job executions may be absent. Empty filtered history does not prove no action ran. Technical completion is not proof of booking or delivery.

GET

action-executions

curl --request GET \
  --url https://platform-api.visitoai.com/m2m/v1/action-executions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform-api.visitoai.com/m2m/v1/action-executions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform-api.visitoai.com/m2m/v1/action-executions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform-api.visitoai.com/m2m/v1/action-executions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform-api.visitoai.com/m2m/v1/action-executions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "enabled": true,
  "loggingStartedAt": "2026-09-30T00:00:00.000Z",
  "range": {
    "from": "2026-09-23T12:01:00.000Z",
    "to": "2026-09-30T12:01:00.000Z"
  },
  "entries": [
    {
      "receiptId": "example-execution",
      "actionId": "http:example-tool",
      "actionVersion": null,
      "name": {
        "en": "Check a request",
        "es": "Consultar una solicitud"
      },
      "type": "http",
      "operation": "check_request",
      "environment": "playground",
      "propertyIds": [
        "example-business"
      ],
      "businesses": [
        {
          "id": "example-business",
          "name": "Example business"
        }
      ],
      "provider": "custom",
      "integrationId": null,
      "operationId": null,
      "reusedExecutionId": null,
      "effectState": null,
      "retryDisposition": null,
      "status": "completed",
      "outcome": "response_received",
      "startedAt": "2026-09-30T12:00:00.000Z",
      "completedAt": "2026-09-30T12:00:00.125Z",
      "durationMs": 125,
      "deliveryStatus": null,
      "submissionId": null,
      "sheetsExecutionId": null,
      "conversationId": null,
      "error": null
    }
  ],
  "nextCursor": null
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

Server-side tenant-scoped credential created from Build > API Keys.

Query Parameters

cursor

string

from

string<date-time>

Inclusive UTC start; defaults to seven days ago.

string<date-time>

Exclusive UTC end; defaults to now.

environment

enum<string>

default:live

Available options:

live,

playground,

developer_test,

all

status

enum<string>

default:all

Available options:

running,

completed,

failed,

all

actionId

string

One canonical action ID, or all (default). For multiple action IDs query each with the same from/to, paginate, merge by execution time and deduplicate conversationIds.

integrationId

string

conversationId

string

Optional conversationId from list_conversations. Omit for business-wide action-first discovery. Restricts receipts to one conversation; does not establish an exact message link.

Response

Successful read

enabled

boolean

required

loggingStartedAt

string | null

required

entries

object[]

required

Show child attributes

nextCursor

string | null

required

range

object

Show child attributes

List action executions

curl --request GET \
  --url https://platform-api.visitoai.com/m2m/v1/action-executions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://platform-api.visitoai.com/m2m/v1/action-executions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://platform-api.visitoai.com/m2m/v1/action-executions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://platform-api.visitoai.com/m2m/v1/action-executions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://platform-api.visitoai.com/m2m/v1/action-executions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "enabled": true,
  "loggingStartedAt": "2026-09-30T00:00:00.000Z",
  "range": {
    "from": "2026-09-23T12:01:00.000Z",
    "to": "2026-09-30T12:01:00.000Z"
  },
  "entries": [
    {
      "receiptId": "example-execution",
      "actionId": "http:example-tool",
      "actionVersion": null,
      "name": {
        "en": "Check a request",
        "es": "Consultar una solicitud"
      },
      "type": "http",
      "operation": "check_request",
      "environment": "playground",
      "propertyIds": [
        "example-business"
      ],
      "businesses": [
        {
          "id": "example-business",
          "name": "Example business"
        }
      ],
      "provider": "custom",
      "integrationId": null,
      "operationId": null,
      "reusedExecutionId": null,
      "effectState": null,
      "retryDisposition": null,
      "status": "completed",
      "outcome": "response_received",
      "startedAt": "2026-09-30T12:00:00.000Z",
      "completedAt": "2026-09-30T12:00:00.125Z",
      "durationMs": 125,
      "deliveryStatus": null,
      "submissionId": null,
      "sheetsExecutionId": null,
      "conversationId": null,
      "error": null
    }
  ],
  "nextCursor": null
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

{
  "error": {
    "code": "M2M_AUTH_INSUFFICIENT_SCOPE",
    "message": "M2M credential does not have required scope.",
    "details": {
      "requiredScopes": [
        "conversations:write"
      ],
      "missingScopes": [
        "conversations:write"
      ]
    }
  }
}

Channels

Conversations

Custom tools

WhatsApp templates

Commerce

Properties

Knowledge

API Reference

Sales CRM

Delivery

Reporting

Webhooks

Actions

Documentation

Tickets

List action executions

Authorizations

Query Parameters

Response