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
- 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
- custom.maniphest.custom-field.difficulty
- custom.maniphest.custom-field.target
- custom.maniphest.custom-field.task-type
- custom.maniphest.custom-field.bot-type
- custom.maniphest.custom-field.req-category
- custom.maniphest.custom-field.impact
- custom.maniphest.custom-field.req-goal
- custom.maniphest.custom-field.phorge-type
- custom.maniphest.custom-field.config-type
- custom.maniphest.custom-field.docs-audience
- custom.maniphest.custom-field.docs-location
- custom.maniphest.custom-field.content-target
- custom.maniphest.custom-field.bug-expected
- custom.maniphest.custom-field.bug-classification
- custom.maniphest.custom-field.impact_repro_temp
- custom.maniphest.custom-field.bug-steps
- custom.maniphest.custom-field.bug-systemdetails
- custom.maniphest.custom-field.impact_production
- custom.maniphest.custom-field.impact_data_loss
- custom.maniphest.custom-field.impact_many_users
- custom.maniphest.custom-field.content-type
- custom.maniphest.custom-field.design-type
- custom.maniphest.custom-field.maintenance-type
- custom.maniphest.custom-field.maintenance-target
- custom.maniphest.custom-field.maintenance-interval
- custom.manifest.custom.field.maintenance-date
- custom.maniphest.custom-field.maintenance-downtime
- custom.maniphest.custom-field.maintenance-announcement
- custom.maniphest.custom-field.abuse-type
- custom.maniphest.custom-field.abuse-reason
- custom.maniphest.custom-field.abuse-filter-id
- custom.maniphest.custom-field.legal-type
- custom.maniphest.custom-field.legal-status
- custom.maniphest.custom-field.security-type
- custom.maniphest.custom-field.security-criticality
- custom.maniphest.custom-field.decision-options
- custom.maniphest.custom-field.decision-who
- custom.maniphest.custom-field.notes
- subtype
- comment
- mfa
- Call Method
- Examples
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
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. | 
| 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.maniphest.custom-field.difficulty | |
| custom.maniphest.custom-field.target | Select für die Komponent: Wiki, Backend, GitHub, Phorge, Mail, Infra, Other | 
| custom.maniphest.custom-field.task-type | Select für Aufgaben-Kategorie: General, Code Review, Orga, Other | 
| custom.maniphest.custom-field.bot-type | Select für Bot-Ticket-Typ: Kein Bot, Wartung, Feature, Bug, Task, Job, Approval, Other | 
| custom.maniphest.custom-field.req-category | Select für Request/Anforderungskategorie: Extension (existing/new), Lua, Gadget, Core, Other | 
| custom.maniphest.custom-field.impact | Select für Impact Themen: Auth, DB, Governance, Performance, Security, UI/UX | 
| custom.maniphest.custom-field.req-goal | Remarkup für Request/Anforderung: Nutzen | 
| custom.maniphest.custom-field.phorge-type | Select für Phorge-Ticket-Typ: Access, Project Request, Field, Form, Dashboard, No | 
| custom.maniphest.custom-field.config-type | Select für Konfigurationsänderung: Rechte, Settings, Extension, Defaults, Namespace, API, Other | 
| custom.maniphest.custom-field.docs-audience | Select für Zielgruppe der Dokumentation: Dev, Admin, Editor, All | 
| custom.maniphest.custom-field.docs-location | Select für Zielort der Dokumentation: Code, GitHub, Wiki | 
| custom.maniphest.custom-field.content-target | Link für Content-Zielseite: Seite, Kategorie oder Bereich | 
| custom.maniphest.custom-field.bug-expected | Remarkup (Bug) für erwartetes Verhalten | 
| custom.maniphest.custom-field.bug-classification | Select für Bug-Klassifikation: UI, Templates, Lua, Extension, Rights, Unknown, Other | 
| custom.maniphest.custom-field.impact_repro_temp | Select für Reproduzierbarkeit: Reproduzierbar, Nicht reproduzierbar, Nur temporär, Unklar | 
| custom.maniphest.custom-field.bug-steps | Remarkup (Bug) für Reproduktion | 
| custom.maniphest.custom-field.bug-systemdetails | Textfeld für Bug: System-Details | 
| custom.maniphest.custom-field.impact_production | Checkbox für Impact Produktionssystem: Betrifft ein produktives System | 
| custom.maniphest.custom-field.impact_data_loss | Checkbox für Impact Datenverlust: Führt zu Datenverlust oder Fehlfunktion | 
| custom.maniphest.custom-field.impact_many_users | Checkbox für Impact viele Nutzer: Viele Nutzer betroffen | 
| custom.maniphest.custom-field.content-type | Select für Content-Änderung: Kategorie, Move, Struktur, Übersetzung, Import, Other | 
| custom.maniphest.custom-field.design-type | Select für Design-Thema | 
| custom.maniphest.custom-field.maintenance-type | Select für Wartungstyp: Server-Update, DB-Wartung, Backup, Logfile, Infra-Change, Routine, Bot-Skript, Downtime, Other | 
| custom.maniphest.custom-field.maintenance-target | Select für Wartungsziel: Webserver, Datenbank, MediaWiki, Extensions, Infra, Bots, Storage, Other | 
| custom.maniphest.custom-field.maintenance-interval | Select für Wartungsintervall: Einmalig, Täglich, Wöchentlich, Monatlich, Vierteljährlich, Jährlich, Other | 
| custom.manifest.custom.field.maintenance-date | Datum für geplante Wartung | 
| custom.maniphest.custom-field.maintenance-downtime | Checkbox für Wartung Downtime: Downtime zu erwarten | 
| custom.maniphest.custom-field.maintenance-announcement | Checkbox für Wartung Ankündigung: Es ist eine Ankündigung oder Wartungsmeldung erforderlich | 
| custom.maniphest.custom-field.abuse-type | Select für Abuse-Ticket-Typ: Filter-Add, Filter-Debug, Whitelist, Blacklist, Spam, Automation, Massaction, Other | 
| custom.maniphest.custom-field.abuse-reason | Select für Abuse-Grund: False Positive, Repeat Abuse, Spam, Pattern, Exception, Other | 
| custom.maniphest.custom-field.abuse-filter-id | Integer für Abuse-Filter-ID: Nummer oder Name des betroffenen Filters (optional) | 
| custom.maniphest.custom-field.legal-type | Select für Legal-Ticket-Typ: Copyright, License, Plagiarism, Document, Other | 
| custom.maniphest.custom-field.legal-status | Select für Legal-Ticket-Status: Open, Review, Resolved, Escalate, Clarify | 
| custom.maniphest.custom-field.security-type | Select für Security-Ticket-Typ: Vulnerability, Auth, Rights, Privacy, Whistle, Compromise, Backdoor, Phishing, Other | 
| custom.maniphest.custom-field.security-criticality | Select für Security-Kritikalität: Critical, High, Medium, Low, Info, No | 
| custom.maniphest.custom-field.decision-options | Remarkup für Entscheidung: Optionen | 
| custom.maniphest.custom-field.decision-who | Select für Entscheidungsträger: Operator, Tech, Admin, Editorial, Other | 
| custom.maniphest.custom-field.notes | Textfeld für zusätzliche Bearbeitungshinweise | 
| 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. | 
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.maniphest.custom-field.difficulty
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.difficulty | 
| value | string | 
custom.maniphest.custom-field.target
Select für die Komponent: Wiki, Backend, GitHub, Phorge, Mail, Infra, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.target | 
| value | string | 
custom.maniphest.custom-field.task-type
Select für Aufgaben-Kategorie: General, Code Review, Orga, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.task-type | 
| value | string | 
custom.maniphest.custom-field.bot-type
Select für Bot-Ticket-Typ: Kein Bot, Wartung, Feature, Bug, Task, Job, Approval, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.bot-type | 
| value | string | 
custom.maniphest.custom-field.req-category
Select für Request/Anforderungskategorie: Extension (existing/new), Lua, Gadget, Core, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.req-category | 
| value | string | 
custom.maniphest.custom-field.impact
Select für Impact Themen: Auth, DB, Governance, Performance, Security, UI/UX
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.impact | 
| value | string | 
custom.maniphest.custom-field.req-goal
Remarkup für Request/Anforderung: Nutzen
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.req-goal | 
| value | string | 
custom.maniphest.custom-field.phorge-type
Select für Phorge-Ticket-Typ: Access, Project Request, Field, Form, Dashboard, No
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.phorge-type | 
| value | string | 
custom.maniphest.custom-field.config-type
Select für Konfigurationsänderung: Rechte, Settings, Extension, Defaults, Namespace, API, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.config-type | 
| value | string | 
custom.maniphest.custom-field.docs-audience
Select für Zielgruppe der Dokumentation: Dev, Admin, Editor, All
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.docs-audience | 
| value | string | 
custom.maniphest.custom-field.docs-location
Select für Zielort der Dokumentation: Code, GitHub, Wiki
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.docs-location | 
| value | string | 
custom.maniphest.custom-field.content-target
Link für Content-Zielseite: Seite, Kategorie oder Bereich
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.content-target | 
| value | string | 
custom.maniphest.custom-field.bug-expected
Remarkup (Bug) für erwartetes Verhalten
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.bug-expected | 
| value | string | 
custom.maniphest.custom-field.bug-classification
Select für Bug-Klassifikation: UI, Templates, Lua, Extension, Rights, Unknown, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.bug-classification | 
| value | string | 
custom.maniphest.custom-field.impact_repro_temp
Select für Reproduzierbarkeit: Reproduzierbar, Nicht reproduzierbar, Nur temporär, Unklar
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.impact_repro_temp | 
| value | string | 
custom.maniphest.custom-field.bug-steps
Remarkup (Bug) für Reproduktion
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.bug-steps | 
| value | string | 
custom.maniphest.custom-field.bug-systemdetails
Textfeld für Bug: System-Details
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.bug-systemdetails | 
| value | string | 
custom.maniphest.custom-field.impact_production
Checkbox für Impact Produktionssystem: Betrifft ein produktives System
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.impact_production | 
| value | bool | 
custom.maniphest.custom-field.impact_data_loss
Checkbox für Impact Datenverlust: Führt zu Datenverlust oder Fehlfunktion
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.impact_data_loss | 
| value | bool | 
custom.maniphest.custom-field.impact_many_users
Checkbox für Impact viele Nutzer: Viele Nutzer betroffen
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.impact_many_users | 
| value | bool | 
custom.maniphest.custom-field.content-type
Select für Content-Änderung: Kategorie, Move, Struktur, Übersetzung, Import, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.content-type | 
| value | string | 
custom.maniphest.custom-field.design-type
Select für Design-Thema
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.design-type | 
| value | string | 
custom.maniphest.custom-field.maintenance-type
Select für Wartungstyp: Server-Update, DB-Wartung, Backup, Logfile, Infra-Change, Routine, Bot-Skript, Downtime, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.maintenance-type | 
| value | string | 
custom.maniphest.custom-field.maintenance-target
Select für Wartungsziel: Webserver, Datenbank, MediaWiki, Extensions, Infra, Bots, Storage, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.maintenance-target | 
| value | string | 
custom.maniphest.custom-field.maintenance-interval
Select für Wartungsintervall: Einmalig, Täglich, Wöchentlich, Monatlich, Vierteljährlich, Jährlich, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.maintenance-interval | 
| value | string | 
custom.manifest.custom.field.maintenance-date
Datum für geplante Wartung
| Key | Type | Description | 
|---|---|---|
| type | const | custom.manifest.custom.field.maintenance-date | 
| value | epoch | 
custom.maniphest.custom-field.maintenance-downtime
Checkbox für Wartung Downtime: Downtime zu erwarten
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.maintenance-downtime | 
| value | bool | 
custom.maniphest.custom-field.maintenance-announcement
Checkbox für Wartung Ankündigung: Es ist eine Ankündigung oder Wartungsmeldung erforderlich
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.maintenance-announcement | 
| value | bool | 
custom.maniphest.custom-field.abuse-type
Select für Abuse-Ticket-Typ: Filter-Add, Filter-Debug, Whitelist, Blacklist, Spam, Automation, Massaction, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.abuse-type | 
| value | string | 
custom.maniphest.custom-field.abuse-reason
Select für Abuse-Grund: False Positive, Repeat Abuse, Spam, Pattern, Exception, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.abuse-reason | 
| value | string | 
custom.maniphest.custom-field.abuse-filter-id
Integer für Abuse-Filter-ID: Nummer oder Name des betroffenen Filters (optional)
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.abuse-filter-id | 
| value | int | 
custom.maniphest.custom-field.legal-type
Select für Legal-Ticket-Typ: Copyright, License, Plagiarism, Document, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.legal-type | 
| value | string | 
custom.maniphest.custom-field.legal-status
Select für Legal-Ticket-Status: Open, Review, Resolved, Escalate, Clarify
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.legal-status | 
| value | string | 
custom.maniphest.custom-field.security-type
Select für Security-Ticket-Typ: Vulnerability, Auth, Rights, Privacy, Whistle, Compromise, Backdoor, Phishing, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.security-type | 
| value | string | 
custom.maniphest.custom-field.security-criticality
Select für Security-Kritikalität: Critical, High, Medium, Low, Info, No
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.security-criticality | 
| value | string | 
custom.maniphest.custom-field.decision-options
Remarkup für Entscheidung: Optionen
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.decision-options | 
| value | string | 
custom.maniphest.custom-field.decision-who
Select für Entscheidungsträger: Operator, Tech, Admin, Editorial, Other
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.decision-who | 
| value | string | 
custom.maniphest.custom-field.notes
Textfeld für zusätzliche Bearbeitungshinweise
| Key | Type | Description | 
|---|---|---|
| type | const | custom.maniphest.custom-field.notes | 
| 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.
-d api.token=api-token \
-d param=value \
...