Covent
Get HelpOpen in app
Docs navigation
Overview
Listings
Individuals
Offers
Walkthroughs
Market intelligence
Polaris
Create A New Polaris ThreadGet A Thread And Its Message HistoryAppend A User Or System Message To An Existing Polaris ThreadStart A Polaris Run For A Specific Assistant Workflow Or IntentGet Run Status, Outputs, And Any Structured Follow-up Artifacts

Polaris

Start A Polaris Run For A Specific Assistant Workflow Or Intent

POSThttps://api.getcovent.com/api/v1/polaris/threads/{id}/runs

Start a Polaris run for a specific assistant workflow or intent.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X POST "https://api.getcovent.com/api/v1/polaris/threads/{id}/runs" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": "investor_lookup",
  "text": "Summarize this buyer's activity in Phoenix.",
  "attachment_ids": [],
  "current_page_context": {
    "resource_type": "individual",
    "resource_id": "ind_123"
  },
  "client_request_id": "req_123"
}'

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json
Content-TypestringRequired

JSON request body header.

Example: application/json

idstringRequired

id path parameter.

Example: <id>

intentstringRequired

intent request field.

Example: investor_lookup
textstringRequired

text request field.

Example: Summarize this buyer's activity in Phoenix.
attachment_idsarrayRequired

attachment_ids request field.

Example: []
current_page_contextobjectRequired

current_page_context request field.

Example: {"resource_type":"individual","resource_id":"ind_123"}
client_request_idstringRequired

client_request_id request field.

Example: req_123

Response

200application/json

idstringRequired

id response field.

Example: run_123
statusstringRequired

status response field.

Example: queued
intentstringRequired

intent response field.

Example: investor_lookup
messagesarrayRequired

messages response field.

Example: []
approvalsarrayRequired

approvals response field.

Example: []
started_atstringRequired

started_at response field.

Example: 2026-04-17T20:02:00Z
completed_atnullRequired

completed_at response field.

Example: null

Response Example

{
  "id": "run_123",
  "status": "queued",
  "intent": "investor_lookup",
  "messages": [],
  "approvals": [],
  "started_at": "2026-04-17T20:02:00Z",
  "completed_at": null
}