Conduit maniphest.edit

maniphest.edit

API Method: maniphest.edit

Returns

map<string, wild>

Errors

ERR-CONDUIT-CORE: See error message for details.

OAuth Scope

OAuth clients may never call this method.

Description

This is a standard ApplicationEditor method which allows you to create and modify objects by applying transactions. For documentation on these endpoints, see Conduit API: Using Edit Endpoints.

Transaction Types

This endpoint supports these types of transactions. See below for detailed information about each transaction type.

Key	Description
parent	Create as a subtask of another task.
column	Move a task to one or more workboard columns.
space	Shift the object between spaces.
subtype	Change the object subtype.
comment	Make comments.
title	Rename the task.
owner	Reassign the task.
status	Change the task status.
priority	Change the priority of the task.
description	Update the task description.
parents.add	Change the parents of this task.
parents.remove	Change the parents of this task.
parents.set	Change the parents of this task.
subtasks.add	Change the subtasks of this task.
subtasks.remove	Change the subtasks of this task.
subtasks.set	Change the subtasks of this task.
view	Change the view policy of the object.
edit	Change the edit policy of the object.
projects.add	Add project tags.
projects.remove	Remove project tags.
projects.set	Set project tags, overwriting current value.
subscribers.add	Add subscribers.
subscribers.remove	Remove subscribers.
subscribers.set	Set subscribers, overwriting current value.
custom.oldid
custom.ref
custom.severity
custom.resolution
custom.reproducibility
custom.reporoduce
custom.info
custom.os
custom.osversion
custom.category

Transaction Type: parent

Create as a subtask of another task.

Key	Type	Description
type	const	parent
value	phid	PHID of the parent task.

Transaction Type: column

Move a task to one or more workboard columns.

You can use this transaction type to create a task into a particular workboard column, or move an existing task between columns.

The transaction value can be specified in several forms. Some are simpler but less powerful, while others are more complex and more powerful.

The simplest valid value is a single column PHID:

"PHID-PCOL-1111"

This will move the task into that column, or create the task into that column if you are creating a new task. If the task is currently on the board, it will be moved out of any exclusive columns. If the task is not currently on the board, it will be added to the board.

You can also perform multiple moves at the same time by passing a list of PHIDs:

["PHID-PCOL-2222", "PHID-PCOL-3333"]

This is equivalent to performing each move individually.

The most complex and most powerful form uses a dictionary to provide additional information about the move, including an optional specific position within the column.

The target column should be identified as columnPHID, and you may select a position by passing either beforePHID or afterPHID, specifying the PHID of a task currently in the column that you want to move this task before or after:

[
  {
    "columnPHID": "PHID-PCOL-4444",
    "beforePHID": "PHID-TASK-5555"
  }
]

Note that this affects only the "natural" position of the task. The task position when the board is sorted by some other attribute (like priority) depends on that attribute value: change a task's priority to move it on priority-sorted boards.

Key	Type	Description
type	const	column
value	list<phid>	List of columns to move the task to.

Transaction Type: space

Shift the object between spaces.

Key	Type	Description
type	const	space
value	phid	New space PHID.

Transaction Type: subtype

Change the object subtype.

Key	Type	Description
type	const	subtype
value	string	New object subtype key.

Transaction Type: comment

Make comments.

Key	Type	Description
type	const	comment
value	string	Comment to add, formatted as remarkup.

Transaction Type: title

Rename the task.

Key	Type	Description
type	const	title
value	string	New task name.

Transaction Type: owner

Reassign the task.

Key	Type	Description
type	const	owner
value	phid\|null	New task owner, or `null` to unassign.

Transaction Type: status

Change the task status.

Key	Type	Description
type	const	status
value	string	New task status constant.

Transaction Type: priority

Change the priority of the task.

Key	Type	Description
type	const	priority
value	string	New task priority constant.

Transaction Type: description

Update the task description.

Key	Type	Description
type	const	description
value	string	New task description.

Transaction Type: parents.add

Change the parents of this task.

Key	Type	Description
type	const	parents.add
value	list<phid>	List of PHIDs to add.

Transaction Type: parents.remove

Change the parents of this task.

Key	Type	Description
type	const	parents.remove
value	list<phid>	List of PHIDs to remove.

Transaction Type: parents.set

Change the parents of this task.

Key	Type	Description
type	const	parents.set
value	list<phid>	List of PHIDs to set.

Transaction Type: subtasks.add

Change the subtasks of this task.

Key	Type	Description
type	const	subtasks.add
value	list<phid>	List of PHIDs to add.

Transaction Type: subtasks.remove

Change the subtasks of this task.

Key	Type	Description
type	const	subtasks.remove
value	list<phid>	List of PHIDs to remove.

Transaction Type: subtasks.set

Change the subtasks of this task.

Key	Type	Description
type	const	subtasks.set
value	list<phid>	List of PHIDs to set.

Transaction Type: view

Change the view policy of the object.

Key	Type	Description
type	const	view
value	string	New policy PHID or constant.

Transaction Type: edit

Change the edit policy of the object.

Key	Type	Description
type	const	edit
value	string	New policy PHID or constant.

Transaction Type: projects.add

Add project tags.

Key	Type	Description
type	const	projects.add
value	list<project>	List of PHIDs to add.

Transaction Type: projects.remove

Remove project tags.

Key	Type	Description
type	const	projects.remove
value	list<project>	List of PHIDs to remove.

Transaction Type: projects.set

Set project tags, overwriting current value.

Key	Type	Description
type	const	projects.set
value	list<project>	List of PHIDs to set.

Transaction Type: subscribers.add

Add subscribers.

Key	Type	Description
type	const	subscribers.add
value	list<user>	List of PHIDs to add.

Transaction Type: subscribers.remove

Remove subscribers.

Key	Type	Description
type	const	subscribers.remove
value	list<user>	List of PHIDs to remove.

Transaction Type: subscribers.set

Set subscribers, overwriting current value.

Key	Type	Description
type	const	subscribers.set
value	list<user>	List of PHIDs to set.

Transaction Type: custom.oldid

Key	Type	Description
type	const	custom.oldid
value	int

Transaction Type: custom.ref

Key	Type	Description
type	const	custom.ref
value	string

Transaction Type: custom.severity

Key	Type	Description
type	const	custom.severity
value	string

Transaction Type: custom.resolution

Key	Type	Description
type	const	custom.resolution
value	string

Transaction Type: custom.reproducibility

Key	Type	Description
type	const	custom.reproducibility
value	string

Transaction Type: custom.reporoduce

Key	Type	Description
type	const	custom.reporoduce
value	string

Transaction Type: custom.info

Key	Type	Description
type	const	custom.info
value	string

Transaction Type: custom.os

Key	Type	Description
type	const	custom.os
value	string

Transaction Type: custom.osversion

Key	Type	Description
type	const	custom.osversion
value	string

Transaction Type: custom.category

Key	Type	Description
type	const	custom.category
value	string

Call Method

Examples

Use the Conduit API Tokens panel in Settings to generate or manage API tokens.
If you submit parameters, these examples will update to show exactly how to encode the parameters you submit.

$ echo <json-parameters> | arc call-conduit --conduit-uri https://feedback.bistudio.com/ --conduit-token <conduit-token> maniphest.edit