Skip to main content
GET
/
v1
/
lexi
/
tasks
List Lexi Tasks
curl --request GET \
  --url https://api.example.com/v1/lexi/tasks
{
  "data": {
    "tasks": [
      {
        "id": "<string>",
        "type": "<string>",
        "status": "<string>",
        "description": "<string>",
        "created_at": "<string>",
        "metadata": {}
      }
    ]
  }
}

​
Request

​
Headers

Authorization: Bearer wbk_your_api_key_here

​
Query Parameters

​
status
string
default:"pending"
Filter by task status: pending, approved, dismissed, completed, failed

​
Response

​
data
object
curl https://nbkxaqxwvkgbddekwsma.supabase.co/functions/v1/api-gateway/v1/lexi/tasks \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Example Response

{
  "data": {
    "tasks": [
      {
        "id": "task-uuid-1",
        "type": "prospect_search",
        "status": "pending",
        "description": "Search for 20 CEOs at law firms in New York",
        "created_at": "2026-02-24T16:00:00Z",
        "metadata": {
          "query": {
            "person_titles": ["CEO"],
            "organization_industries": ["Legal"],
            "person_locations": ["New York"]
          },
          "per_page": 20
        }
      },
      {
        "id": "task-uuid-2",
        "type": "campaign_start",
        "status": "pending",
        "description": "Start campaign 'Q2 Outreach' for 150 contacts",
        "created_at": "2026-02-24T15:30:00Z",
        "metadata": {
          "campaign_id": "campaign-uuid",
          "contact_count": 150
        }
      }
    ]
  }
}

​
Filter by Status

​
Get Only Pending Tasks

curl "https://nbkxaqxwvkgbddekwsma.supabase.co/functions/v1/api-gateway/v1/lexi/tasks?status=pending" \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Get Approved Tasks

curl "https://nbkxaqxwvkgbddekwsma.supabase.co/functions/v1/api-gateway/v1/lexi/tasks?status=approved" \
  -H "Authorization: Bearer wbk_your_api_key_here"

​
Task Types

TypeDescription
prospect_searchSearch for prospects and save to CRM
campaign_startLaunch an outreach campaign
contact_updateBulk update contacts
list_operationCreate/modify lists

​
Task Statuses

StatusDescription
pendingAwaiting your approval
approvedApproved, executing now
completedSuccessfully executed
dismissedYou dismissed the task
failedExecution failed

​
Polling for Tasks

Poll this endpoint periodically to check for new tasks requiring approval. Alternatively, use webhooks when available.
import time

while True:
    response = requests.get(f"{BASE_URL}/v1/lexi/tasks", headers=headers)
    tasks = response.json()["data"]["tasks"]
    
    if tasks:
        print(f"Found {len(tasks)} pending tasks")
        for task in tasks:
            print(f"  - {task['description']}")
            # Auto-approve or notify user
    
    time.sleep(60)  # Check every minute

​
Errors

StatusCodeDescription
401invalid_keyInvalid API key
403insufficient_permissionsMissing lexi permission
429rate_limitedRate limit exceeded