Conduit maniphest.edit

maniphest.edit

API Method: maniphest.edit

Summary

Apply transactions to create a new task or edit an existing one.

Returns

map<string, wild>

Errors

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

OAuth Scope

OAuth clients may never call this method.

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 Summary

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.
title	Rename the task.
owner	Reassign the task.
status	Change the task status.
priority	Change the priority of the task.
points	Change the task point value.
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.
commits.add	Change the related commits for this task.
commits.remove	Change the related commits for this task.
commits.set	Change the related commits for 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.mycompany:extticket
custom.mycompany:estimated-hours
custom.mycompany:todos
custom.mycompany:errortype
custom.mycompany:customerversion
custom.mycompany:beta
custom.mycompany:probassigned
custom.mycompany:sideeffects
custom.mycompany:kundeninfocheck
custom.mycompany:needed-hours
custom.mycompany:devops
custom.mycompany:tests
custom.mycompany:serialisierungsAenderung
custom.mycompany:ismerged
custom.mycompany:branch
custom.mycompany:mergebranch
custom.mycompany:noplanning
custom.mycompany:errorwhiletesting
custom.mycompany:review
custom.mycompany:abhaengig
custom.mycompany:sprintname
custom.mycompany:plannedDate
custom.mycompany:erledigtDate
custom.mycompany:timespan
custom.mycompany:danger
custom.mycompany:consequences
custom.mycompany:horniness
custom.mycompany:neues
custom.mycompany:shacommit
custom.mycompany:extrainfo
custom.mycompany:urgency
custom.mycompany:video
custom.mycompany:leadtask
custom.mycompany:changeDate
custom.mycompany:teststatus
custom.mycompany:buddy
subtype	Change the object subtype.
comment	Make comments.
mfa	Sign this transaction group with MFA.

parent

Create as a subtask of another task.

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

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 beforePHIDs or afterPHIDs, specifying the PHIDs of tasks currently in the column that you want to move this task before or after:

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

When you specify multiple PHIDs, the task will be moved adjacent to the first valid PHID found in either of the lists. This allows positional moves to generally work as users expect even if the client view of the board has fallen out of date and some of the nearby tasks have moved elsewhere.

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

space

Shift the object between spaces.

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

title

Rename the task.

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

owner

Reassign the task.

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

status

Change the task status.

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

priority

Change the priority of the task.

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

points

Change the task point value.

Key	Type	Description
type	const	points
value	points	New task point value.

description

Update the task description.

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

parents.add

Change the parents of this task.

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

parents.remove

Change the parents of this task.

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

parents.set

Change the parents of this task.

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

subtasks.add

Change the subtasks of this task.

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

subtasks.remove

Change the subtasks of this task.

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

subtasks.set

Change the subtasks of this task.

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

commits.add

Change the related commits for this task.

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

commits.remove

Change the related commits for this task.

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

commits.set

Change the related commits for this task.

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

view

Change the view policy of the object.

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

edit

Change the edit policy of the object.

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

projects.add

Add project tags.

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

projects.remove

Remove project tags.

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

projects.set

Set project tags, overwriting current value.

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

subscribers.add

Add subscribers.

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

subscribers.remove

Remove subscribers.

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

subscribers.set

Set subscribers, overwriting current value.

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

custom.mycompany:extticket

Key	Type	Description
type	const	custom.mycompany:extticket
value	string

custom.mycompany:estimated-hours

Key	Type	Description
type	const	custom.mycompany:estimated-hours
value	int

custom.mycompany:todos

Key	Type	Description
type	const	custom.mycompany:todos
value	string

custom.mycompany:errortype

Key	Type	Description
type	const	custom.mycompany:errortype
value	string

custom.mycompany:customerversion

Key	Type	Description
type	const	custom.mycompany:customerversion
value	int

custom.mycompany:beta

Key	Type	Description
type	const	custom.mycompany:beta
value	bool

custom.mycompany:probassigned

Key	Type	Description
type	const	custom.mycompany:probassigned
value	string

custom.mycompany:sideeffects

Key	Type	Description
type	const	custom.mycompany:sideeffects
value	string

custom.mycompany:kundeninfocheck

Key	Type	Description
type	const	custom.mycompany:kundeninfocheck
value	bool

custom.mycompany:needed-hours

Key	Type	Description
type	const	custom.mycompany:needed-hours
value	int

custom.mycompany:devops

Key	Type	Description
type	const	custom.mycompany:devops
value	string

custom.mycompany:tests

Key	Type	Description
type	const	custom.mycompany:tests
value	string

custom.mycompany:serialisierungsAenderung

Key	Type	Description
type	const	custom.mycompany:serialisierungsAenderung
value	bool

custom.mycompany:ismerged

Key	Type	Description
type	const	custom.mycompany:ismerged
value	bool

custom.mycompany:branch

Key	Type	Description
type	const	custom.mycompany:branch
value	string

custom.mycompany:mergebranch

Key	Type	Description
type	const	custom.mycompany:mergebranch
value	string

custom.mycompany:noplanning

Key	Type	Description
type	const	custom.mycompany:noplanning
value	bool

custom.mycompany:errorwhiletesting

Key	Type	Description
type	const	custom.mycompany:errorwhiletesting
value	bool

custom.mycompany:review

Key	Type	Description
type	const	custom.mycompany:review
value	string

custom.mycompany:abhaengig

Key	Type	Description
type	const	custom.mycompany:abhaengig
value	string

custom.mycompany:sprintname

Key	Type	Description
type	const	custom.mycompany:sprintname
value	int

custom.mycompany:plannedDate

Key	Type	Description
type	const	custom.mycompany:plannedDate
value	epoch

custom.mycompany:erledigtDate

Key	Type	Description
type	const	custom.mycompany:erledigtDate
value	epoch

custom.mycompany:timespan

Key	Type	Description
type	const	custom.mycompany:timespan
value	string

custom.mycompany:danger

Key	Type	Description
type	const	custom.mycompany:danger
value	string

custom.mycompany:consequences

Key	Type	Description
type	const	custom.mycompany:consequences
value	string

custom.mycompany:horniness

Key	Type	Description
type	const	custom.mycompany:horniness
value	string

custom.mycompany:neues

Key	Type	Description
type	const	custom.mycompany:neues
value	string

custom.mycompany:shacommit

Key	Type	Description
type	const	custom.mycompany:shacommit
value	string

custom.mycompany:extrainfo

Key	Type	Description
type	const	custom.mycompany:extrainfo
value	string

custom.mycompany:urgency

Key	Type	Description
type	const	custom.mycompany:urgency
value	string

custom.mycompany:video

Key	Type	Description
type	const	custom.mycompany:video
value	bool

custom.mycompany:leadtask

Key	Type	Description
type	const	custom.mycompany:leadtask
value	bool

custom.mycompany:changeDate

Key	Type	Description
type	const	custom.mycompany:changeDate
value	epoch

custom.mycompany:teststatus

Key	Type	Description
type	const	custom.mycompany:teststatus
value	string

custom.mycompany:buddy

Key	Type	Description
type	const	custom.mycompany:buddy
value	string

subtype

Change the object subtype.

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

comment

Make comments.

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

mfa

Sign this transaction group with MFA.

Key	Type	Description
type	const	mfa
value	bool

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://phab.isl-kocher.com/ --conduit-token <conduit-token> -- maniphest.edit