Project data model

Updated:

View field support, webhooks, and list parameters for each integration on the Supported Integrations page.

Data Model
FieldTypeRequiredDescription
idstringNo
created_atstring (date-time)No(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
updated_atstring (date-time)No(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
namestringNoThe project's name
parent_idstringNo
user_idsstring[]No(reference to HrisEmployee)
group_idsstring[]No(reference to HrisGroup)
descriptionstringNo
has_tasksbooleanNoIf you can use this project ID to list tasks. Default is true.
has_childrenbooleanNoIf this project has children folders / lists
metadataTaskMetadata[]No
metadata[].idstringNoThe ID of the custom field definition (from the metadata/metadata endpoint).
metadata[].valueobjectNoThe field's value, typed by `format`: DATE as ISO-8601 (`YYYY-MM-DD`, or `YYYY-MM-DDTHH:MM:SSZ` for date-times); NUMBER, PRICE and CURRENCY as a number; BOOLEAN and YES_NO as true/false; MULTIPLE_SELECT as an array of option values; otherwise a string.
metadata[].namespacestringNo
metadata[].formatenumNoThe data type of the custom field, which determines how `value` is formatted. Values: TEXT, NUMBER, DATE, BOOLEAN, FILE, TEXTAREA, SINGLE_SELECT, MULTIPLE_SELECT, MEASUREMENT, PRICE, YES_NO, CURRENCY, URL
metadata[].extra_dataobjectNo
metadata[].slugstringNoThe integration's API name (key) of an existing custom field. List valid slugs for this object with the metadata/metadata endpoint; unknown slugs are rejected by the integration.

TypeScript

TypeScript
export type TaskProject = {
	id?: string;
	created_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	updated_at?: string-time; // (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
	name?: string; // The project's name
	parent_id?: string;
	user_ids?: string[]; // (reference to HrisEmployee)
	group_ids?: string[]; // (reference to HrisGroup)
	description?: string;
	has_tasks?: boolean; // If you can use this project ID to list tasks. Default is true.
	has_children?: boolean; // If this project has children folders / lists
	metadata?: [];
	raw?: any;
}

Zod

Zod
import { z } from 'zod';

export const ZodTaskProject = z.object({
	id: z.string().optional(),
	created_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	updated_at: z.string-time().optional().describe("(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"),
	name: z.string().optional().describe("The project's name"),
	parent_id: z.string().optional(),
	user_ids: z.array().optional().describe("(reference to HrisEmployee)"),
	group_ids: z.array().optional().describe("(reference to HrisGroup)"),
	description: z.string().optional(),
	has_tasks: z.boolean().optional().describe("If you can use this project ID to list tasks. Default is true."),
	has_children: z.boolean().optional().describe("If this project has children folders / lists"),
	metadata: z.array().optional(),

});

Python

Python
import dataclasses

@dataclasses.dataclass
class TaskProject:
	id: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	created_at: Optional[str]
	"""(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)"""
	updated_at: Optional[str]
	"""The project's name"""
	name: Optional[str]
	parent_id: Optional[str]
	"""(reference to HrisEmployee)"""
	user_ids: Optional[List[List[str]]]
	"""(reference to HrisGroup)"""
	group_ids: Optional[List[List[str]]]
	description: Optional[str]
	"""If you can use this project ID to list tasks. Default is true."""
	has_tasks: Optional[bool]
	"""If this project has children folders / lists"""
	has_children: Optional[bool]
	metadata: Optional[PropertyTaskProjectMetadata]
Are we missing anything? Let us know
Was this page helpful?