After successfully running a query, deploy it with one click:

1. In your query interface (where you see the code and results)
2. Click the “Deploy” button
3. That’s it! Your query is now available as an API endpoint

Deploy button in the query interface

Now let’s explore what’s available in the Deploy section:

1. Navigate to the “Deploy” section in the left sidebar
2. You’ll see three key areas:
   • API Logs: Monitor API usage and performance
   • Direct Endpoints: Test individual query APIs
   • Unified Endpoints: Natural language API access

Deploy section showing logs and endpoint options

Direct endpoints give you traditional API access to each query:

1. Click on your deployed query (e.g., “calculate_campaign_roas”)
2. You’ll see a Postman-like interface for testing

Direct endpoint testing interface

Key features:

• Endpoint URL: Each query has a unique endpoint URL
• Query Parameters: Customize results with filters
• Response Preview: See actual data returned
• Code Examples: Get implementation code in multiple languages

The Unified Endpoint is a powerful natural language API:

1. Click “Unified Endpoints” in the Deploy section
2. Access the “Chat Completions” interface

Chat Completions interface for natural language queries

How it works:

• Single Endpoint: One API URL with your project ID that handles all queries
• Natural Language: Ask questions like “your question here”
• Auto-routing: Automatically selects the right query program
• Flexible: No need to remember specific endpoint names

Example request:

curl -X 'POST' \
  'https://annalect-api.infactory.ai/v1/run/[PROJECT-ID]/chat/completions' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer $INFACTORY_API_KEY' \
  -d '{
  "messages": [
    {
      "role": "user",
      "content": "your question here"
    }
  ],
  "model": "infactory-v1"
}'

​

Understanding Unified Endpoint Responses

The unified endpoint returns two types of responses depending on whether your question matches a deployed query:

​

1. Matched Query Response

When your question matches a deployed query, you receive the actual data results:

{
  "id": "chatcmpl-1752600911",
  "object": "chat.completion",
  "created": 1752600911,
  "model": "infactory-v1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "tool",
      "content": {
        "items": {
          "MAIN": {
            "item": {
              "rows": [
                ["ag11", 970807],
                ["ag42", 929173],
                ["ag15", 924427]
                // ... more data rows
              ]
            }
          }
        }
      }
    }
  }]
}

Key indicators of a matched query:

• The content contains an items object with actual data
• rows array contains your query results
• Response includes execution details and data schema

​

2. Non-Matched Query Response

When your question doesn’t match any deployed query, you receive suggested questions:

{
  "id": "chatcmpl-1752600833",
  "object": "chat.completion",
  "created": 1752600833,
  "model": "infactory-v1",
  "choices": [{
    "index": 0,
    "message": {
      "role": "tool",
      "content": {
        "kind": "PublishedQueries",
        "data": {
          "project_id": "02c0b9df-874a-43fd-9cca-3e9e7da22d71",
          "queries": [
            {
              "id": "9618dc6d-ccbc-4d83-944d-8e6d1b2ad60f",
              "cue": "What's the ROAS for each campaign",
              "name": null
            },
            {
              "id": "5db2f947-c01f-495d-b3cf-4d207ea3a44d",
              "cue": "What's the ROI for each campaign or ad group?",
              "name": null
            }
            // ... more available queries
          ]
        }
      }
    }
  }]
}

Key indicators of a non-matched query:

• The content has kind: "PublishedQueries"
• Contains a list of available queries with their cue (suggested questions)
• No actual data rows returned

Monitor your API usage and performance:

1. Click “API Logs” to see real-time activity
2. Track requests, response times, and errors

API logs showing usage and performance metrics