Create User

Create a new dashboard user.

WARNING

Requires super-admin role.

Endpoint

INFO

POST /api/v1/dashboard/users

Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer {token}	Yes

Request Body

Parameter	Type	Required	Description
name	string	Yes	User name
email	string	Yes	Email address
password	string	Yes	Password (min: 8 chars)
role	string	Yes	User role
partner_id	integer	Conditional	Required for partner/agency roles
agency_id	integer	Conditional	Required for agency roles

Example Request

curl -X POST https://api.daakey.com/api/v1/dashboard/users \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "name": "New Agency Admin",
    "email": "admin@newagency.com",
    "password": "securePassword123",
    "role": "agency_admin",
    "partner_id": 1,
    "agency_id": 1
  }'

Response

Success (201)

{
  "success": true,
  "message": "User created",
  "data": {
    "id": 10,
    "name": "New Agency Admin",
    "email": "admin@newagency.com",
    "role": "agency_admin",
    "status": "active",
    "partner": {
      "id": 1,
      "name": "Acme Car Rentals"
    },
    "agency": {
      "id": 1,
      "name": "Downtown Agency"
    },
    "created_at": "2024-01-15T00:00:00Z"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

User Roles

Role	Description	Required Fields
super_admin	Full system access	None
partner_admin	Partner management	partner_id
agency_admin	Agency management	partner_id, agency_id
agency_staff	Limited agency access	partner_id, agency_id