{
  "info": {
    "_postman_id": "avelto-api-v1",
    "name": "Avelto API v1",
    "description": "Public REST API for the Avelto AI sales assistant platform. Manage agents, channels, conversations, leads, knowledge sources, and outbound webhooks programmatically. All requests authenticate with a workspace-scoped API token issued from /app/settings/api-tokens.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.avelto.pl/api/v1"
    },
    {
      "key": "apiToken",
      "value": "convo_xxx"
    }
  ],
  "item": [
    {
      "name": "GET /conversations",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/conversations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "conversations"
          ]
        },
        "description": "List conversations"
      }
    },
    {
      "name": "GET /conversations/{id}",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/conversations/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "conversations",
            ":id"
          ]
        },
        "description": "Fetch a conversation"
      }
    },
    {
      "name": "POST /conversations/{id}/operator-message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/conversations/{id}/operator-message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "conversations",
            ":id",
            "operator-message"
          ]
        },
        "description": "Send an operator-authored message",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "POST /conversations/bulk",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/conversations/bulk",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "conversations",
            "bulk"
          ]
        },
        "description": "Bulk close / reopen / assign / tag conversations",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "GET /leads",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/leads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "leads"
          ]
        },
        "description": "List leads"
      }
    },
    {
      "name": "POST /leads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/leads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "leads"
          ]
        },
        "description": "Create a lead",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "PATCH /leads/{id}/status",
      "request": {
        "method": "PATCH",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/leads/{id}/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "leads",
            ":id",
            "status"
          ]
        },
        "description": "Update lead pipeline status",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "POST /leads/bulk-update",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/leads/bulk-update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "leads",
            "bulk-update"
          ]
        },
        "description": "Bulk update lead statuses",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "POST /leads/bulk-delete",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/leads/bulk-delete",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "leads",
            "bulk-delete"
          ]
        },
        "description": "Bulk soft-delete leads",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "GET /agents",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents"
          ]
        },
        "description": "List agents"
      }
    },
    {
      "name": "POST /agents",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents"
          ]
        },
        "description": "Create an agent (OWNER role only)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "GET /agents/{id}",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents",
            ":id"
          ]
        },
        "description": "Fetch an agent"
      }
    },
    {
      "name": "PATCH /agents/{id}",
      "request": {
        "method": "PATCH",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents",
            ":id"
          ]
        },
        "description": "Update an agent (OWNER role only)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "DELETE /agents/{id}",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents",
            ":id"
          ]
        },
        "description": "Delete an agent"
      }
    },
    {
      "name": "POST /agents/{id}/publish",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/agents/{id}/publish",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "agents",
            ":id",
            "publish"
          ]
        },
        "description": "Publish an agent"
      }
    },
    {
      "name": "GET /channels",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channels",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channels"
          ]
        },
        "description": "List channels"
      }
    },
    {
      "name": "DELETE /channels/{id}",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/channels/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "channels",
            ":id"
          ]
        },
        "description": "Delete a channel"
      }
    },
    {
      "name": "GET /knowledge/sources",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/knowledge/sources",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "knowledge",
            "sources"
          ]
        },
        "description": "List knowledge sources"
      }
    },
    {
      "name": "POST /knowledge/upload",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/knowledge/upload",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "knowledge",
            "upload"
          ]
        },
        "description": "Upload a file (PDF / DOCX / TXT / HTML / MD)"
      }
    },
    {
      "name": "POST /knowledge/crawl",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/knowledge/crawl",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "knowledge",
            "crawl"
          ]
        },
        "description": "Crawl a URL into the knowledge base",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "GET /integrations",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/integrations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "integrations"
          ]
        },
        "description": "List integrations (includes webhooks)"
      }
    },
    {
      "name": "POST /integrations/webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/integrations/webhook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "integrations",
            "webhook"
          ]
        },
        "description": "Subscribe to outbound webhook events",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "DELETE /integrations/{id}",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/integrations/{id}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "integrations",
            ":id"
          ]
        },
        "description": "Soft-delete an integration / webhook"
      }
    },
    {
      "name": "POST /widget/session",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiToken}}",
            "type": "text"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/widget/session",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "widget",
            "session"
          ]
        },
        "description": "Anonymous widget session bootstrap",
        "body": {
          "mode": "raw",
          "raw": "{\n  \n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}