Authentication

Request example

{
  "name": "Jane Doe",
  "email": "owner@acme.com",
  "password": "SecurePass123!",
  "businessName": "Acme Corp"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/auth/register" \
  -H "Content-Type: application/json"
  -d '{  "name": "Jane Doe",  "email": "owner@acme.com",  "password": "SecurePass123!",  "businessName": "Acme Corp"}'

Response example201

{
  "success": true,
  "data": {
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG...",
    "expiresIn": "7d",
    "user": {
      "id": "uuid",
      "email": "owner@acme.com",
      "name": "Jane Doe",
      "role": "owner",
      "tenantId": "uuid",
      "tenantName": "Acme Corp"
    }
  }
}

Request example

{
  "email": "owner@acme.com",
  "password": "SecurePass123!"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/auth/login" \
  -H "Content-Type: application/json"
  -d '{  "email": "owner@acme.com",  "password": "SecurePass123!"}'

Response example200

{
  "success": true,
  "data": {
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG...",
    "expiresIn": "7d",
    "user": { "id": "uuid", "email": "owner@acme.com", "role": "owner" }
  }
}

Request example

{ "refreshToken": "eyJhbG..." }

Code examples

curl -X POST "https://api.actiwapi.com/api/auth/refresh" \
  -H "Content-Type: application/json"
  -d '{ "refreshToken": "eyJhbG..." }'

Response example200

{
  "success": true,
  "data": {
    "accessToken": "eyJhbG...",
    "refreshToken": "eyJhbG...",
    "expiresIn": "7d"
  }
}

Headers

Code examples

curl -X GET "https://api.actiwapi.com/api/auth/profile" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"

Response example200

{
  "success": true,
  "data": {
    "id": "uuid",
    "email": "owner@acme.com",
    "name": "Jane Doe",
    "role": "owner",
    "tenantId": "uuid",
    "tenantName": "Acme Corp"
  }
}

Headers

Request example

{
  "name": "Production server",
  "permissions": ["messages:send", "messages:read", "sessions:read"]
}

Code examples

curl -X POST "https://api.actiwapi.com/api/v1/api-keys" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "name": "Production server",  "permissions": ["messages:send", "messages:read", "sessions:read"]}'

Response example201

{
  "success": true,
  "data": {
    "id": "uuid",
    "name": "Production server",
    "keyPrefix": "awp_live_",
    "apiKey": "awp_live_xxxxxxxxxxxxxxxx",
    "permissions": ["messages:send", "messages:read", "sessions:read"]
  }
}