Projects API

Manage projects for clients across all tenants

The Projects API enables you to create and manage projects for your clients. Each project can be categorized by type (AgriTech, design, consulting) and tracks requirements, status, and client association.

List Projects

cURL

curl -X GET "https://bknd.fata.plus/api/projects" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"

Retrieves all projects for the authenticated tenant.

Endpoint: GET /api/projects

Query Parameters

client_id · string

Filter projects by client ID

status · string

Filter by project status: pending, active, or completed

category · string

Filter by category: agri-tech, design, or consulting

Response

data · array

Array of project objects

Show Project Object

id · string

Unique project identifier

client_id · string

ID of the client who owns this project

title · string

Project title

description · text

Detailed project description

status · string

Current status: pending, active, or completed

category · string

Project category: agri-tech, design, or consulting

requirements · json

Project requirements and specifications in JSON format

created_at · datetime

Project creation timestamp

updated_at · datetime

Last update timestamp

Response

{
  "data": [
    {
      "id": "proj_abc123",
      "client_id": "client_xyz789",
      "title": "Smart Irrigation System",
      "description": "IoT-based irrigation management for rice farms",
      "status": "active",
      "category": "agri-tech",
      "requirements": {
        "farm_size": "5 hectares",
        "crop_type": "rice",
        "sensors": ["soil_moisture", "weather"]
      },
      "created_at": "2026-03-01T10:30:00Z",
      "updated_at": "2026-03-02T14:20:00Z"
    }
  ]
}

Create Project

cURL

curl -X POST "https://bknd.fata.plus/api/projects" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "client_xyz789",
    "title": "Smart Irrigation System",
    "description": "IoT-based irrigation management",
    "status": "pending",
    "category": "agri-tech",
    "requirements": {
      "farm_size": "5 hectares",
      "crop_type": "rice"
    }
  }'

Creates a new project for a client.

Endpoint: POST /api/projects

Request Body

client_id · string · required

ID of the client who owns this project

title · string · required

Project title

description · text · required

Detailed project description

status · string · default: "pending"

Initial status: pending, active, or completed

category · string · required

Project category: agri-tech, design, or consulting

requirements · json

Project requirements and specifications in JSON format

Response

data · object

The created project object with all fields including generated id, created_at, and updated_at

Response

{
  "data": {
    "id": "proj_abc123",
    "client_id": "client_xyz789",
    "title": "Smart Irrigation System",
    "description": "IoT-based irrigation management",
    "status": "pending",
    "category": "agri-tech",
    "requirements": {
      "farm_size": "5 hectares",
      "crop_type": "rice"
    },
    "created_at": "2026-03-03T09:15:00Z",
    "updated_at": "2026-03-03T09:15:00Z"
  }
}

Permissions

Project access is controlled by role-based permissions:

• Read: admin, client - Both admins and clients can view projects
• Write: admin, client - Both admins and clients can create and update projects

Clients can only access their own projects through tenant isolation.