OBAPI OBAPI

Tasks

Project tasks. A task always belongs to a project.

Endpoints

  • GET /obapi/v1/tasks -- list (optionally filtered by project)
  • GET /obapi/v1/tasks/{id} -- single
  • GET /obapi/v1/projects/{id}/tasks -- list tasks for a specific project

Parameters

page, per_page, project_id, status, sort

Response (list)

{
    "items": [
        {
            "id": "42",
            "ref": "TK2405-0010",
            "label": "Data migration",
            "project_ref": "PJ2405-0003",
            "date_start": "2024-07-01",
            "date_end": "2024-07-31",
            "progress": 35,
            "status": "validated"
        }
    ],
    "pagination": { "..." }
}

Response (single)

{
    "task": {
        "id": "42",
        "ref": "TK2405-0010",
        "label": "Data migration",
        "description": "Migrate all customer and invoice data from legacy system",
        "project_ref": "PJ2405-0003",
        "date_start": "2024-07-01",
        "date_end": "2024-07-31",
        "planned_hours": "120.00",
        "spent_hours": "45.00",
        "progress": 35,
        "priority": 2,
        "created_at": "2024-05-01T10:30:00Z",
        "updated_at": "2024-07-15T16:00:00Z",
        "status": "validated",
        "public_note": ""
    }
}

Notes

  • planned_hours and spent_hours are string representations of decimal hours.
  • progress is a percentage from 0 to 100.
  • priority is an integer (higher value = higher priority).