The unified inbox stores every WhatsApp conversation across your connected sessions. Authorize these routes with X-API-Key (messages:read to list, messages:send to reply).

Inbound and outbound messages are synced automatically when a session is connected. Threads are scoped to your workspace. Members see conversations they are allowed to access; owners and admins see the full inbox.

How the inbox works

Each thread is one contact talking to one WhatsApp session. When a message arrives or is sent, ActiWAPI upserts the thread, stores the message, and pushes a Socket.io update so the dashboard does not need to poll.

Phone numbers are stored in canonical form (digits with country code, mapped to @s.whatsapp.net). Linked-device LID identifiers are resolved to the phone JID whenever possible so inbound and outbound history stay on the same thread.

List threads with search, session filter, and status (open / resolved).
Load paginated messages for a thread, then send a text or media reply.
Assign a teammate or resolve the thread when the conversation is done.

Replying with media

Upload a file with POST /api/chats/upload first. The response includes a media URL (and path). Pass that URL on POST /api/chats/{threadId}/send together with messageType (image, document, audio, video) and optional fileName / mimetype.

Authorize inbox calls with X-API-Key (messages:read to list, messages:send to reply). Outbound sends from the Messages API land in the same inbox.

GET/api/chats

List threads

Paginated inbox threads for the authenticated workspace, newest activity first.

URL: https://api.actiwapi.com/api/chats

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Query parameters

page — Page number (default 1)
limit — Items per page (default 20)
search — Filter by contact name or phone
sessionId — Limit to one WhatsApp session UUID
status — open, resolved, or omit for all

Code examples

curl -X GET "https://api.actiwapi.com/api/chats" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats", {
    method: "GET",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.get(
    "https://api.actiwapi.com/api/chats",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->get("https://api.actiwapi.com/api/chats");

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapGet("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.actiwapi.com/api/chats");
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.actiwapi.com/api/chats", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": [{
    "id": "uuid",
    "sessionId": "uuid",
    "remoteJid": "919876543210@s.whatsapp.net",
    "contactName": "Priya",
    "phone": "919876543210",
    "lastMessage": "Thanks, that worked",
    "unreadCount": 1,
    "status": "open",
    "assignedUserId": null,
    "updatedAt": "2026-09-03T12:00:00.000Z"
  }],
  "pagination": { "page": 1, "limit": 20, "total": 12, "pages": 1 }
}

Try in Swagger UI

GET/api/chats/{threadId}/messages

Get thread messages

Paginated message history for a single conversation.

URL: https://api.actiwapi.com/api/chats/{threadId}/messages

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Path parameters

threadId — Inbox thread UUID

Query parameters

page — Page number
limit — Messages per page

Code examples

curl -X GET "https://api.actiwapi.com/api/chats/{threadId}/messages" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/messages", {
    method: "GET",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/messages", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.get(
    "https://api.actiwapi.com/api/chats/{threadId}/messages",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/messages")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats/{threadId}/messages");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->get("https://api.actiwapi.com/api/chats/{threadId}/messages");

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats/{threadId}/messages";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapGet("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.actiwapi.com/api/chats/{threadId}/messages");
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.actiwapi.com/api/chats/{threadId}/messages", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats/{threadId}/messages"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": [{
    "id": "uuid",
    "direction": "inbound",
    "messageType": "text",
    "content": "Hi, I need help",
    "status": "delivered",
    "createdAt": "2026-09-03T12:00:00.000Z"
  }],
  "pagination": { "page": 1, "limit": 50, "total": 8, "pages": 1 }
}

Try in Swagger UI

POST/api/chats/upload

Upload inbox media

Upload a file for use in an inbox reply. Send as multipart/form-data.

URL: https://api.actiwapi.com/api/chats/upload

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	If JSON

Request example

Form field: file (binary)

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/upload" \
  -H "Content-Type: multipart/form-data" \
  -H "X-API-Key: {apiKey}"
  -d 'Form field: file (binary)'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/upload", {
    method: "POST",
    headers: {
    "Content-Type": "multipart/form-data",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify(Form field: file (binary)),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats/upload", {
  method: "POST",
  headers: {
    "Content-Type": "multipart/form-data",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify(Form field: file (binary)),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/upload",
    headers={
        "Content-Type": "multipart/form-data",
        "X-API-Key": "{apiKey}",
    },
    json=Form field: file (binary),
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/upload")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "multipart/form-data"
request["X-API-Key"] = "{apiKey}"
request.body = "Form field: file (binary)"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats/upload");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => 'Form field: file (binary)',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'multipart/form-data',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/chats/upload", json_decode('Form field: file (binary)', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats/upload";
var content = new StringContent("""
Form field: file (binary)
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
Form field: file (binary)
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/upload")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`Form field: file (binary)`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/upload", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "multipart/form-data")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats/upload"))
    .method("POST", HttpRequest.BodyPublishers.ofString("Form field: file (binary)"))
      .header("Content-Type", "multipart/form-data")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "url": "/uploads/...",
    "path": "uploads/...",
    "fileName": "photo.jpg",
    "mimetype": "image/jpeg"
  }
}

Try in Swagger UI

POST/api/chats/{threadId}/send

Send a reply

Reply on an existing thread. Provide text and/or mediaUrl.

URL: https://api.actiwapi.com/api/chats/{threadId}/send

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Path parameters

threadId — Inbox thread UUID

Request example

{
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
}

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/send" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"
  -d '{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/send", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify({
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify({
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/{threadId}/send",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
    json={
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/send")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"
request.body = "{  \"text\": \"We can help with that.\",  \"mediaUrl\": null,  \"messageType\": \"text\",  \"fileName\": null,  \"mimetype\": null}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats/{threadId}/send");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => '{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/chats/{threadId}/send", json_decode('{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats/{threadId}/send";
var content = new StringContent("""
{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/{threadId}/send")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/{threadId}/send", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats/{threadId}/send"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"text\": \"We can help with that.\",  \"mediaUrl\": null,  \"messageType\": \"text\",  \"fileName\": null,  \"mimetype\": null}"))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": { "id": "uuid", "status": "queued", "direction": "outbound" }
}

Try in Swagger UI

POST/api/chats/{threadId}/assign

Assign an agent

Assign the thread to a workspace user. Pass userId null to unassign.

URL: https://api.actiwapi.com/api/chats/{threadId}/assign

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Path parameters

threadId — Inbox thread UUID

Request example

{ "userId": "uuid" }

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/assign" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"
  -d '{ "userId": "uuid" }'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/assign", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify({ "userId": "uuid" }),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/assign", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify({ "userId": "uuid" }),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/{threadId}/assign",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
    json={ "userId": "uuid" },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/assign")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"
request.body = "{ \"userId\": \"uuid\" }"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats/{threadId}/assign");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => '{ "userId": "uuid" }',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/chats/{threadId}/assign", json_decode('{ "userId": "uuid" }', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats/{threadId}/assign";
var content = new StringContent("""
{ "userId": "uuid" }
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{ "userId": "uuid" }
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/{threadId}/assign")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{ "userId": "uuid" }`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/{threadId}/assign", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats/{threadId}/assign"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"userId\": \"uuid\" }"))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{ "success": true, "data": { "id": "uuid", "assignedUserId": "uuid" } }

Try in Swagger UI

POST/api/chats/{threadId}/resolve

Resolve a thread

Mark the conversation resolved. New inbound messages typically reopen it.

URL: https://api.actiwapi.com/api/chats/{threadId}/resolve

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Path parameters

threadId — Inbox thread UUID

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/resolve" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/resolve", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/resolve", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/{threadId}/resolve",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/resolve")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"

response = http.request(request)
puts response.body

$ch = curl_init("https://api.actiwapi.com/api/chats/{threadId}/resolve");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->get("https://api.actiwapi.com/api/chats/{threadId}/resolve");

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/chats/{threadId}/resolve";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapGet("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/{threadId}/resolve");
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/{threadId}/resolve", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/chats/{threadId}/resolve"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{ "success": true, "data": { "id": "uuid", "status": "resolved" } }

Try in Swagger UI

Error codes

Failed requests return a JSON envelope with success: false and a human-readable message.

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "phone": "Valid phone number is required"
  }
}

HTTP	Code	Description
400	VALIDATION_ERROR	Request body or query failed validation.
401	UNAUTHORIZED	Missing or invalid JWT / API key.
403	FORBIDDEN	Authenticated but lacking permission or entitlement.
403	SUBSCRIPTION_INACTIVE	Action not allowed on the current plan (including Free after trial). Upgrade or wait for entitlements.
403	LIMIT_EXCEEDED	Plan limit reached (sessions, messages, API requests, etc.).
404	NOT_FOUND	Resource does not exist or is not in your account.
409	CONFLICT	Duplicate resource or invalid state transition.
429	RATE_LIMITED	Too many requests; retry after backoff.
500	INTERNAL_ERROR	Unexpected server error.
502	WHATSAPP_UNAVAILABLE	WhatsApp session disconnected or provider error.