メインコンテンツへ
BlueAI
ホーム/プロジェクト管理/データ構造

プロジェクト管理 データ構造

プロジェクト管理 API で返却される主要オブジェクトのフィールド定義です。

|

ID 形式

各リソースは prefix 付き public ID(例: deal_..., inv_..., form_..., ak_...)を利用します。

全プロダクト共通の ID 規約

Project object

プロジェクト管理のプロジェクトを表すオブジェクトです。

フィールド

名前必須説明
id
string必須プロジェクト ID
object
string必須オブジェクト種別(`project.project`)
organization_id
string必須組織 ID
name
string必須プロジェクト名
description
string | null任意説明
start_date
string | null任意開始日
end_date
string | null任意終了日
created_at
string必須作成日時 (ISO 8601)
updated_at
string必須更新日時 (ISO 8601)
{
  "id": "proj_01JQ3KXYZ",
  "object": "project.project",
  "organization_id": "org_01HZXYZ",
  "name": "Website Redesign",
  "description": "Redesign the corporate website",
  "start_date": "2026-02-01",
  "end_date": "2026-04-30",
  "created_at": "2026-01-20T09:00:00Z",
  "updated_at": "2026-02-20T10:00:00Z"
}

Task object

プロジェクト内のタスクを表すオブジェクトです。

フィールド

名前必須説明
id
string必須タスク ID
object
string必須オブジェクト種別(`project.task`)
project_id
string必須プロジェクト ID
group_id
string | null任意タスクグループ ID
name
string必須タスク名
start_date
string | null任意開始日
end_date
string | null任意終了日
progress
number必須進捗率 (0-100)
assigned_to
string | null任意担当者 ID
created_at
string必須作成日時 (ISO 8601)
updated_at
string必須更新日時 (ISO 8601)
{
  "id": "task_01JQ3KABC",
  "object": "project.task",
  "project_id": "proj_01JQ3KXYZ",
  "group_id": "grp_01JQ3KDEF",
  "name": "Design mockups",
  "start_date": "2026-02-01",
  "end_date": "2026-02-14",
  "progress": 75,
  "assigned_to": "usr_01HZABC",
  "created_at": "2026-01-25T09:00:00Z",
  "updated_at": "2026-02-18T16:00:00Z"
}

Link object

タスク間の依存関係リンクを表すオブジェクトです。

フィールド

名前必須説明
id
string必須リンク ID
object
string必須オブジェクト種別(`project.link`)
project_id
string必須プロジェクト ID
source_id
string必須先行タスク ID
target_id
string必須後続タスク ID
type
"finish_to_start" | "start_to_start" | "finish_to_finish"必須リンク種別
{
  "id": "link_01JQ3KGHI",
  "object": "project.link",
  "project_id": "proj_01JQ3KXYZ",
  "source_id": "task_01JQ3KABC",
  "target_id": "task_01JQ3KJKL",
  "type": "finish_to_start"
}