task

QUERY

task(taskId: ID!): Task

Arguments

taskId

ID!

required

Returns

Task

ID!

ref

String!

Short human-readable identifier for this task (e.g. T-123), as shown in the Plain app.

title

String!

description

String

Optional longer description providing context or instructions for the task.

status

TaskStatus!

priority

Int!

Numeric priority value; lower numbers indicate higher priority.

company

Company

The company this task is linked to, if any. Mutually exclusive with tenant.

tenant

Tenant

The tenant this task is linked to, if any. Mutually exclusive with company.

assignedTo

TaskAssignee

The user or machine user currently assigned to this task, or null if unassigned.

assignedAt

DateTime

When the task was most recently assigned.

threadLinks

ThreadLinkConnection!

Paginated list of threads linked to this task.

Arguments

first

Int

after

String

last

Int

before

String

createdAt

createdBy

updatedAt

updatedBy

isDeleted

Boolean!

True if this task has been soft-deleted. Deleted tasks are excluded from the tasks list query but remain fetchable by ID.

deletedAt

DateTime

When the task was deleted, or null if it has not been deleted.

deletedBy

InternalActor

Who deleted the task, or null if it has not been deleted.

Query

query Task($taskId: ID!) {
  task(taskId: $taskId) {
    id
    ref
    title
    description
    status
    priority
  }
}

Variables

{
  "taskId": "id"
}

Response

{
  "data": {
    "task": {
      "id": "id",
      "ref": "string",
      "title": "string",
      "description": "string",
      "status": "TODO",
      "priority": 1
    }
  }
}

⌘I

Query

query Task($taskId: ID!) {
  task(taskId: $taskId) {
    id
    ref
    title
    description
    status
    priority
  }
}

Variables

{
  "taskId": "id"
}

Response

{
  "data": {
    "task": {
      "id": "id",
      "ref": "string",
      "title": "string",
      "description": "string",
      "status": "TODO",
      "priority": 1
    }
  }
}

Queries

Mutations

Types

Arguments

Returns