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.

Descripció

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.

Clau	Descripció
parent	Crear com a subtasca d'una altra tasca.
column	Mou una tasca a una o més columnes del pafó.
space	Shift the object between spaces.
title	Reanomena la tasca.
owner	Reassigna la tasca.
status	Canvia l'estat de la tasca.
priority	Canvia la prioritat de la tasca.
points	Canvia la puntuació de la tasca.
description	Actualitza la descripció de la tasca.
parents.add	Canvia els pares d'aquesta tasca.
parents.remove	Canvia els pares d'aquesta tasca.
parents.set	Canvia els pares d'aquesta tasca.
subtasks.add	Canvia les subtasques d'aquesta tasca.
subtasks.remove	Canvia les subtasques d'aquesta tasca.
subtasks.set	Canvia les subtasques d'aquesta tasca.
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	Afegeix subscriptors.
subscribers.remove	Elimina subscriptors.
subscribers.set	Indica els subscriptors, sobreescrivint el valor actual.
subtype	Change the object subtype.
comment	Make comments.
mfa	Sign this transaction group with MFA.

Transaction Type: parent

Crear com a subtasca d'una altra tasca.

Clau	Type	Descripció
type	const	parent
value	phid	PHID de la tasca mare

Transaction Type: column

Mou una tasca a una o més columnes del pafó.

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.

Clau	Type	Descripció
type	const	column
value	list<phid>	Llista de columnes on moure la tasca.

Transaction Type: space

Shift the object between spaces.

Clau	Type	Descripció
type	const	space
value	phid	New space PHID.

Transaction Type: title

Reanomena la tasca.

Clau	Type	Descripció
type	const	title
value	string	Nou nom de la tasca.

Transaction Type: owner

Reassigna la tasca.

Clau	Type	Descripció
type	const	owner
value	phid\|null	Nou propietari de la tasca, o `null` per desassignar.

Transaction Type: status

Canvia l'estat de la tasca.

Clau	Type	Descripció
type	const	status
value	string	Nova constant d'estat de tasca.

Transaction Type: priority

Canvia la prioritat de la tasca.

Clau	Type	Descripció
type	const	priority
value	string	Nova constant de prioritat de tasca.

Transaction Type: points

Canvia la puntuació de la tasca.

Clau	Type	Descripció
type	const	points
value	points	Nova puntuació de la tasca.

Transaction Type: description

Actualitza la descripció de la tasca.

Clau	Type	Descripció
type	const	description
value	string	Nova descripció de la tasca.

Transaction Type: parents.add

Canvia els pares d'aquesta tasca.

Clau	Type	Descripció
type	const	parents.add
value	list<phid>	List of PHIDs to add.

Transaction Type: parents.remove

Canvia els pares d'aquesta tasca.

Clau	Type	Descripció
type	const	parents.remove
value	list<phid>	List of PHIDs to remove.

Transaction Type: parents.set

Canvia els pares d'aquesta tasca.

Clau	Type	Descripció
type	const	parents.set
value	list<phid>	List of PHIDs to set.

Transaction Type: subtasks.add

Canvia les subtasques d'aquesta tasca.

Clau	Type	Descripció
type	const	subtasks.add
value	list<phid>	List of PHIDs to add.

Transaction Type: subtasks.remove

Canvia les subtasques d'aquesta tasca.

Clau	Type	Descripció
type	const	subtasks.remove
value	list<phid>	List of PHIDs to remove.

Transaction Type: subtasks.set

Canvia les subtasques d'aquesta tasca.

Clau	Type	Descripció
type	const	subtasks.set
value	list<phid>	List of PHIDs to set.

Transaction Type: commits.add

Change the related commits for this task.

Clau	Type	Descripció
type	const	commits.add
value	list<phid>	List of PHIDs to add.

Transaction Type: commits.remove

Change the related commits for this task.

Clau	Type	Descripció
type	const	commits.remove
value	list<phid>	List of PHIDs to remove.

Transaction Type: commits.set

Change the related commits for this task.

Clau	Type	Descripció
type	const	commits.set
value	list<phid>	List of PHIDs to set.

Transaction Type: view

Change the view policy of the object.

Clau	Type	Descripció
type	const	view
value	string	New policy PHID or constant.

Transaction Type: edit

Change the edit policy of the object.

Clau	Type	Descripció
type	const	edit
value	string	New policy PHID or constant.

Transaction Type: projects.add

Add project tags.

Clau	Type	Descripció
type	const	projects.add
value	list<project>	List of PHIDs to add.

Transaction Type: projects.remove

Remove project tags.

Clau	Type	Descripció
type	const	projects.remove
value	list<project>	List of PHIDs to remove.

Transaction Type: projects.set

Set project tags, overwriting current value.

Clau	Type	Descripció
type	const	projects.set
value	list<project>	List of PHIDs to set.

Transaction Type: subscribers.add

Afegeix subscriptors.

Clau	Type	Descripció
type	const	subscribers.add
value	list<user>	List of PHIDs to add.

Transaction Type: subscribers.remove

Elimina subscriptors.

Clau	Type	Descripció
type	const	subscribers.remove
value	list<user>	List of PHIDs to remove.

Transaction Type: subscribers.set

Indica els subscriptors, sobreescrivint el valor actual.

Clau	Type	Descripció
type	const	subscribers.set
value	list<user>	List of PHIDs to set.

Transaction Type: subtype

Change the object subtype.

Clau	Type	Descripció
type	const	subtype
value	string	New object subtype key.

Transaction Type: comment

Make comments.

Clau	Type	Descripció
type	const	comment
value	string	Comment to add, formatted as remarkup.

Transaction Type: mfa

Sign this transaction group with MFA.

Clau	Type	Descripció
type	const	mfa
value	bool

Call Method

Exemples

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://projectes.commonscloud.coop/ --conduit-token <conduit-token> -- maniphest.edit