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.
Conduit diffusion.commit.edit
diffusion.commit.edit
diffusion.commit.edit
API Method: diffusion.commit.edit
API Method: diffusion.commit.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.
Description
Transaction Types
Transaction Types
This endpoint supports these types of transactions. See below for detailed information about each transaction type.
| Key | Description |
|---|---|
| auditors.add | Change the auditors for this commit. |
| auditors.remove | Change the auditors for this commit. |
| auditors.set | Change the auditors for this commit. |
| accept | |
| concern | |
| verify | |
| resign | |
| 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. |
| comment | Make comments. |
| mfa | Sign this transaction group with MFA. |
Transaction Type: auditors.add
Transaction Type: auditors.add
Change the auditors for this commit.
| Key | Type | Description |
|---|---|---|
| type | const | auditors.add |
| value | list<phid> | List of PHIDs to add. |
Transaction Type: auditors.remove
Transaction Type: auditors.remove
Change the auditors for this commit.
| Key | Type | Description |
|---|---|---|
| type | const | auditors.remove |
| value | list<phid> | List of PHIDs to remove. |
Transaction Type: auditors.set
Transaction Type: auditors.set
Change the auditors for this commit.
| Key | Type | Description |
|---|---|---|
| type | const | auditors.set |
| value | list<phid> | List of PHIDs to set. |
Transaction Type: accept
Transaction Type: accept
| Key | Type | Description |
|---|---|---|
| type | const | accept |
| value | bool |
Transaction Type: concern
Transaction Type: concern
| Key | Type | Description |
|---|---|---|
| type | const | concern |
| value | bool |
Transaction Type: verify
Transaction Type: verify
| Key | Type | Description |
|---|---|---|
| type | const | verify |
| value | bool |
Transaction Type: resign
Transaction Type: resign
| Key | Type | Description |
|---|---|---|
| type | const | resign |
| value | bool |
Transaction Type: projects.add
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
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
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
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
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
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
Transaction Type: jira.issues
Lists associated JIRA issues.
| Key | Type | Description |
|---|---|---|
| type | const | jira.issues |
| value | list<string> |
Transaction Type: comment
Transaction Type: comment
Make comments.
| Key | Type | Description |
|---|---|---|
| type | const | comment |
| value | string | Comment to add, formatted as remarkup. |
Transaction Type: mfa
Transaction Type: 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 http://qa.in-portal.org/ --conduit-token <conduit-token> diffusion.commit.edit
$ curl http://qa.in-portal.org/api/diffusion.commit.edit \
-d api.token=api-token \
-d param=value \
...
-d api.token=api-token \
-d param=value \
...
<?php
require_once 'path/to/libphutil/src/__phutil_library_init__.php';
$api_token = "<api-token>";
$api_parameters = array(<parameters>);
$client = new ConduitClient('http://qa.in-portal.org/');
$client->setConduitToken($api_token);
$result = $client->callMethodSynchronous('diffusion.commit.edit', $api_parameters);
print_r($result);