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
- update
- title
- author
- summary
- testPlan
- reviewers.add
- reviewers.remove
- reviewers.set
- repositoryPHID
- tasks.add
- tasks.remove
- tasks.set
- parents.add
- parents.remove
- parents.set
- children.add
- children.remove
- children.set
- plan-changes
- request-review
- close
- reopen
- abandon
- accept
- reclaim
- reject
- commandeer
- resign
- draft
- view
- edit
- projects.add
- projects.remove
- projects.set
- subscribers.add
- subscribers.remove
- subscribers.set
- phabricator:auditors
- comment
- mfa
- Call Method
- Examples
Conduit differential.revision.edit
differential.revision.edit
differential.revision.edit
API Method: differential.revision.edit
API Method: differential.revision.edit
Login Required: This method requires authentication. You must log in before you can make calls to it.
- 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 |
|---|---|
| update | Create or update a revision with a diff. |
| title | Retitle the revision. |
| author | Foist this revision upon another user. |
| 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. |
| phabricator:auditors | Allows commits to trigger audits explicitly. |
| comment | Make comments. |
| mfa | Sign this transaction group with MFA. |
update
update
Create or update a revision with a diff.
| Key | Type | Description |
|---|---|---|
| type | const | update |
| value | phid | PHID of the diff. |
title
title
Retitle the revision.
| Key | Type | Description |
|---|---|---|
| type | const | title |
| value | string | New revision title. |
author
author
Foist this revision upon another user.
| Key | Type | Description |
|---|---|---|
| type | const | author |
| value | phid | New author. |
summary
summary
Change the revision summary.
| Key | Type | Description |
|---|---|---|
| type | const | summary |
| value | string | New revision summary. |
testPlan
testPlan
Update the revision test plan.
| Key | Type | Description |
|---|---|---|
| type | const | testPlan |
| value | string | New test plan. |
reviewers.add
reviewers.add
Change the reviewers for this revision.
| Key | Type | Description |
|---|---|---|
| type | const | reviewers.add |
| value | list<phid> | List of PHIDs to add. |
reviewers.remove
reviewers.remove
Change the reviewers for this revision.
| Key | Type | Description |
|---|---|---|
| type | const | reviewers.remove |
| value | list<phid> | List of PHIDs to remove. |
reviewers.set
reviewers.set
Change the reviewers for this revision.
| Key | Type | Description |
|---|---|---|
| type | const | reviewers.set |
| value | list<phid> | List of PHIDs to set. |
repositoryPHID
repositoryPHID
Change the repository for this revision.
| Key | Type | Description |
|---|---|---|
| type | const | repositoryPHID |
| value | phid | New repository. |
tasks.add
tasks.add
Change associated tasks.
| Key | Type | Description |
|---|---|---|
| type | const | tasks.add |
| value | list<phid> | List of PHIDs to add. |
tasks.remove
tasks.remove
Change associated tasks.
| Key | Type | Description |
|---|---|---|
| type | const | tasks.remove |
| value | list<phid> | List of PHIDs to remove. |
tasks.set
tasks.set
Change associated tasks.
| Key | Type | Description |
|---|---|---|
| type | const | tasks.set |
| value | list<phid> | List of PHIDs to set. |
parents.add
parents.add
Change associated parent revisions.
| Key | Type | Description |
|---|---|---|
| type | const | parents.add |
| value | list<phid> | List of PHIDs to add. |
parents.remove
parents.remove
Change associated parent revisions.
| Key | Type | Description |
|---|---|---|
| type | const | parents.remove |
| value | list<phid> | List of PHIDs to remove. |
parents.set
parents.set
Change associated parent revisions.
| Key | Type | Description |
|---|---|---|
| type | const | parents.set |
| value | list<phid> | List of PHIDs to set. |
children.add
children.add
Change associated child revisions.
| Key | Type | Description |
|---|---|---|
| type | const | children.add |
| value | list<phid> | List of PHIDs to add. |
children.remove
children.remove
Change associated child revisions.
| Key | Type | Description |
|---|---|---|
| type | const | children.remove |
| value | list<phid> | List of PHIDs to remove. |
children.set
children.set
Change associated child revisions.
| Key | Type | Description |
|---|---|---|
| type | const | children.set |
| value | list<phid> | List of PHIDs to set. |
plan-changes
plan-changes
| Key | Type | Description |
|---|---|---|
| type | const | plan-changes |
| value | bool |
request-review
request-review
| Key | Type | Description |
|---|---|---|
| type | const | request-review |
| value | bool |
close
close
| Key | Type | Description |
|---|---|---|
| type | const | close |
| value | bool |
reopen
reopen
| Key | Type | Description |
|---|---|---|
| type | const | reopen |
| value | bool |
abandon
abandon
| Key | Type | Description |
|---|---|---|
| type | const | abandon |
| value | bool |
accept
accept
| Key | Type | Description |
|---|---|---|
| type | const | accept |
| value | bool |
reclaim
reclaim
| Key | Type | Description |
|---|---|---|
| type | const | reclaim |
| value | bool |
reject
reject
| Key | Type | Description |
|---|---|---|
| type | const | reject |
| value | bool |
commandeer
commandeer
| Key | Type | Description |
|---|---|---|
| type | const | commandeer |
| value | bool |
resign
resign
| Key | Type | Description |
|---|---|---|
| type | const | resign |
| value | bool |
draft
draft
Change autosubmission from draft state after builds finish.
| Key | Type | Description |
|---|---|---|
| type | const | draft |
| value | bool | New "Hold as Draft" setting. |
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. |
phabricator:auditors
phabricator:auditors
Allows commits to trigger audits explicitly.
| Key | Type | Description |
|---|---|---|
| type | const | phabricator:auditors |
| value | list<phid> |
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://phab.xyz/ --conduit-token <conduit-token> -- differential.revision.edit
$ curl https://phab.xyz/api/differential.revision.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://phab.xyz/');
$client->setConduitToken($api_token);
$result = $client->callMethodSynchronous('differential.revision.edit', $api_parameters);
print_r($result);