taskByRef
Fetch a single task by its short human-readable ref (e.g. T-123), as displayed in the Plain app. Returns null if no task matches. Requires the task:read permission.
taskByRef(ref: String!): TaskArguments
Returns
Short human-readable identifier for this task (e.g. T-123), as shown in the Plain app.
Optional longer description providing context or instructions for the task.
Numeric priority value; lower numbers indicate higher priority.
The company this task is linked to, if any. Mutually exclusive with tenant.
The tenant this task is linked to, if any. Mutually exclusive with company.
The user or machine user currently assigned to this task, or null if unassigned.
When the task was most recently assigned.
Paginated list of threads linked to this task.
True if this task has been soft-deleted. Deleted tasks are excluded from the tasks list query but remain fetchable by ID.
When the task was deleted, or null if it has not been deleted.
Who deleted the task, or null if it has not been deleted.