Conduit differential.revision.edit

differential.revision.edit

API Method: differential.revision.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
update	Create or update a revision with a diff.
title	Retitle the revision.
summary	Change the revision summary.
testPlan	Update the revision test plan.
reviewers.add	Change the reviewers for this revision.
reviewers.remove	Change the reviewers for this revision.
reviewers.set	Change the reviewers for this revision.
repositoryPHID	Change the repository for this revision.
tasks.add	Change associated tasks.
tasks.remove	Change associated tasks.
tasks.set	Change associated tasks.
parents.add	Change associated parent revisions.
parents.remove	Change associated parent revisions.
parents.set	Change associated parent revisions.
children.add	Change associated child revisions.
children.remove	Change associated child revisions.
children.set	Change associated child revisions.
plan-changes
request-review
close
reopen
abandon
accept
reclaim
reject
commandeer
resign
draft	Change autosubmission from draft state after builds finish.
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.
jira.issues	Lists associated JIRA issues.
phabricator:auditors	Allows commits to trigger audits explicitly.
comment	Make comments.
mfa	Sign this transaction group with MFA.

Transaction Type: update

Create or update a revision with a diff.

Key	Type	Description
type	const	update
value	phid	PHID of the diff.

Transaction Type: title

Retitle the revision.

Key	Type	Description
type	const	title
value	string	New revision title.

Transaction Type: summary

Change the revision summary.

Key	Type	Description
type	const	summary
value	string	New revision summary.

Transaction Type: testPlan

Update the revision test plan.

Key	Type	Description
type	const	testPlan
value	string	New test plan.

Transaction Type: reviewers.add

Change the reviewers for this revision.

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

Transaction Type: reviewers.remove

Change the reviewers for this revision.

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

Transaction Type: reviewers.set

Change the reviewers for this revision.

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

Transaction Type: repositoryPHID

Change the repository for this revision.

Key	Type	Description
type	const	repositoryPHID
value	phid	New repository.

Transaction Type: tasks.add

Change associated tasks.

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

Transaction Type: tasks.remove

Change associated tasks.

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

Transaction Type: tasks.set

Change associated tasks.

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

Transaction Type: parents.add

Change associated parent revisions.

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

Transaction Type: parents.remove

Change associated parent revisions.

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

Transaction Type: parents.set

Change associated parent revisions.

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

Transaction Type: children.add

Change associated child revisions.

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

Transaction Type: children.remove

Change associated child revisions.

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

Transaction Type: children.set

Change associated child revisions.

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

Transaction Type: plan-changes

Key	Type	Description
type	const	plan-changes
value	bool

Transaction Type: request-review

Key	Type	Description
type	const	request-review
value	bool

Transaction Type: close

Key	Type	Description
type	const	close
value	bool

Transaction Type: reopen

Key	Type	Description
type	const	reopen
value	bool

Transaction Type: abandon

Key	Type	Description
type	const	abandon
value	bool

Transaction Type: accept

Key	Type	Description
type	const	accept
value	bool

Transaction Type: reclaim

Key	Type	Description
type	const	reclaim
value	bool

Transaction Type: reject

Key	Type	Description
type	const	reject
value	bool

Transaction Type: commandeer

Key	Type	Description
type	const	commandeer
value	bool

Transaction Type: resign

Key	Type	Description
type	const	resign
value	bool

Transaction Type: draft

Change autosubmission from draft state after builds finish.

Key	Type	Description
type	const	draft
value	bool	New "Hold as Draft" setting.

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: jira.issues

Lists associated JIRA issues.

Key	Type	Description
type	const	jira.issues
value	list<string>

Transaction Type: phabricator:auditors

Allows commits to trigger audits explicitly.

Key	Type	Description
type	const	phabricator:auditors
value	list<phid>

Transaction Type: comment

Make comments.

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

Transaction Type: 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 http://qa.in-portal.org/ --conduit-token <conduit-token> differential.revision.edit