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.
- Overview
- Documentation
- Transaction Summary
- parent
- column
- space
- title
- owner
- status
- priority
- points
- description
- parents.add
- parents.remove
- parents.set
- subtasks.add
- subtasks.remove
- subtasks.set
- commits.add
- commits.remove
- commits.set
- view
- edit
- projects.add
- projects.remove
- projects.set
- subscribers.add
- subscribers.remove
- subscribers.set
- subtype
- comment
- mfa
- Call Method
- Examples
Conduit maniphest.edit
maniphest.edit
maniphest.edit
API Method: maniphest.edit
API Method: maniphest.edit
Login Required: This method requires authentication. You must log in before you can make calls to it.
- 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
Method Description
Transaction Summary
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. |
| subtype | Change the object subtype. |
| comment | Make comments. |
| mfa | Sign this transaction group with MFA. |
parent
parent
Create as a subtask of another task.
| Key | Type | Description |
|---|---|---|
| type | const | parent |
| value | phid | PHID of the parent task. |
column
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
space
Shift the object between spaces.
| Key | Type | Description |
|---|---|---|
| type | const | space |
| value | phid | New space PHID. |
title
title
Rename the task.
| Key | Type | Description |
|---|---|---|
| type | const | title |
| value | string | New task name. |
owner
owner
Reassign the task.
| Key | Type | Description |
|---|---|---|
| type | const | owner |
| value | phid|null | New task owner, or `null` to unassign. |
status
status
Change the task status.
| Key | Type | Description |
|---|---|---|
| type | const | status |
| value | string | New task status constant. |
priority
priority
Change the priority of the task.
| Key | Type | Description |
|---|---|---|
| type | const | priority |
| value | string | New task priority constant. |
points
points
Change the task point value.
| Key | Type | Description |
|---|---|---|
| type | const | points |
| value | points | New task point value. |
description
description
Update the task description.
| Key | Type | Description |
|---|---|---|
| type | const | description |
| value | string | New task description. |
parents.add
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
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
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
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
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
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
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
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
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
view
Change the view policy of the object.
| Key | Type | Description |
|---|---|---|
| type | const | view |
| value | string | New policy PHID or constant. |
edit
edit
Change the edit policy of the object.
| Key | Type | Description |
|---|---|---|
| type | const | edit |
| value | string | New policy PHID or constant. |
projects.add
projects.add
Add project tags.
| Key | Type | Description |
|---|---|---|
| type | const | projects.add |
| value | list<project> | List of PHIDs to add. |
projects.remove
projects.remove
Remove project tags.
| Key | Type | Description |
|---|---|---|
| type | const | projects.remove |
| value | list<project> | List of PHIDs to remove. |
projects.set
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
subscribers.add
Add subscribers.
| Key | Type | Description |
|---|---|---|
| type | const | subscribers.add |
| value | list<user> | List of PHIDs to add. |
subscribers.remove
subscribers.remove
Remove subscribers.
| Key | Type | Description |
|---|---|---|
| type | const | subscribers.remove |
| value | list<user> | List of PHIDs to remove. |
subscribers.set
subscribers.set
Set subscribers, overwriting current value.
| Key | Type | Description |
|---|---|---|
| type | const | subscribers.set |
| value | list<user> | List of PHIDs to set. |
subtype
subtype
Change the object subtype.
| Key | Type | Description |
|---|---|---|
| type | const | subtype |
| value | string | New object subtype key. |
comment
comment
Make comments.
| Key | Type | Description |
|---|---|---|
| type | const | comment |
| value | string | Comment to add, formatted as remarkup. |
mfa
mfa
Sign this transaction group with MFA.
| Key | Type | Description |
|---|---|---|
| type | const | mfa |
| value | bool |
Call Method
Call Method
Examples
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://ticket.majava.org/ --conduit-token <conduit-token> -- maniphest.edit
$ curl https://ticket.majava.org/api/maniphest.edit \
-d api.token=api-token \
-d param=value \
...
-d api.token=api-token \
-d param=value \
...
<?php
require_once 'path/to/arcanist/support/init/init-script.php';
$api_token = "<api-token>";
$api_parameters = array(<parameters>);
$client = new ConduitClient('https://ticket.majava.org/');
$client->setConduitToken($api_token);
$result = $client->callMethodSynchronous('maniphest.edit', $api_parameters);
print_r($result);