Vexly Public API

The Vexly public API lets you create async agent runs from any script or application, including cross-service business and product analysis workflows.

Base URL:

https://api.vexly.io/api/v1/public

Core Endpoints

Create a run:

POST /agent/runs

Check a run:

GET /agent/runs/{run_id}

Stream status:

GET /agent/runs/{run_id}/events

List artifacts:

GET /agent/runs/{run_id}/artifacts

Request Pattern

{
  "prompt": "Review last week's performance across all connected services and return the top 5 changes or risks."
}

Response Pattern

The API returns a run_id, thread_id, current status, and URLs you can poll.

When a run is complete, the response also includes:

• final result
• artifact metadata
• billing summary in credits, not internal USD cost

Language Examples

• Python
• JavaScript / Node
• PHP
• Perl
• Go
• Java
• curl
• Bash

Authentication

Use a PAT for the fastest start. See Authentication.