Export leads - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

This route currently requires an authenticated user session. Developer API keys are blocked by the backend for this route.

Body parameters

selection · optional
object
Bulk selection object with mode (ids or descriptor), descriptor filter, search, scope, etc.
filter · optional
object
FilterDescriptor tree (used when selection is omitted).
search · optional
string
Free-text search (used when selection is omitted).
sort · optional
array<object>
Sort specs.
column_ids · optional
array<string>
Preferred visible Lead column IDs; mutually exclusive with fields. Must resolve to exportable columns unless research_field_ids supplies an export column.
fields · optional
array<string>
Legacy Lead field names/aliases; mutually exclusive with column_ids and restricted to exportable standard or defined custom fields.
research_field_ids · optional
array<string>
Research column IDs to include.
source_table_id · optional
string
Research table context.
source_table_scope · optional
string
Research scope: company or lead.
scope · optional
string
Lead scope: org or user.
format · optional
string
Accepted by the request model; this route queues CSV.

Name	Type	Description
selection	object	Bulk selection object with mode (ids or descriptor), descriptor filter, search, scope, etc.
filter	object	FilterDescriptor tree (used when selection is omitted).
search	string	Free-text search (used when selection is omitted).
sort	array<object>	Sort specs.
column_ids	array<string>	Preferred visible Lead column IDs; mutually exclusive with fields. Must resolve to exportable columns unless research_field_ids supplies an export column.
fields	array<string>	Legacy Lead field names/aliases; mutually exclusive with column_ids and restricted to exportable standard or defined custom fields.
research_field_ids	array<string>	Research column IDs to include.
source_table_id	string	Research table context.
source_table_scope	string	Research scope: company or lead.
scope	string	Lead scope: org or user.
format	string	Accepted by the request model; this route queues CSV.

Errors

Status	Meaning
400	Invalid filter descriptor or export fields.
401	Missing or invalid user session.
403	Developer API keys are blocked for this session-only route.
503	Export queue admission failed.

Example

bash

curl -X POST "https://app.autotouch.ai/api/leads/export" \
    -H "Authorization: Bearer <user_session_token>" \
    -H "Content-Type: application/json" \
    -d '{"scope":"org","fields":["first_name","last_name","email"]}'

Request body

json

{
    "selection": {
      "mode": "descriptor",
      "descriptor": {
        "root": {
          "kind": "rule",
          "field": "lead_status",
          "operator": "eq",
          "value": "qualified"
        }
      },
      "scope": "org"
    },
    "fields": ["first_name", "last_name", "email", "company_domain"],
    "source_table_id": "tbl_123",
    "research_field_ids": ["col_456"]
  }

Response example

json

{
    "type": "background_task",
    "task_id": "abc123-def456",
    "status": "queued",
    "message": "Export queued for processing",
    "status_url": "/api/leads/export-status/abc123-def456"
  }