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 calendar.event.edit
calendar.event.edit
calendar.event.edit
API Method: calendar.event.edit
API Method: calendar.event.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 event 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 |
|---|---|
| space | Shift the object between spaces. |
| name | Rename the event. |
| isAllDay | Make the event an all day event. |
| start | Change the start time of the event. |
| end | Change the end time of the event. |
| cancelled | Cancel or restore the event. |
| hostPHID | Change the host of the event. |
| inviteePHIDs | Change invited users. |
| description | Update the event description. |
| icon | Change the event icon. |
| isRecurring | Make the event recurring. |
| frequency | Change the event frequency. |
| until | Change when the event repeats until. |
| 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. |
| comment | Make comments. |
| mfa | Sign this transaction group with MFA. |
space
space
Shift the object between spaces.
| Key | Type | Description |
|---|---|---|
| type | const | space |
| value | phid | New space PHID. |
name
name
Rename the event.
| Key | Type | Description |
|---|---|---|
| type | const | name |
| value | string | New event name. |
isAllDay
isAllDay
Make the event an all day event.
| Key | Type | Description |
|---|---|---|
| type | const | isAllDay |
| value | bool | Mark the event as an all day event. |
start
start
Change the start time of the event.
| Key | Type | Description |
|---|---|---|
| type | const | start |
| value | epoch | New event start time. |
end
end
Change the end time of the event.
| Key | Type | Description |
|---|---|---|
| type | const | end |
| value | epoch | New event end time. |
cancelled
cancelled
Cancel or restore the event.
| Key | Type | Description |
|---|---|---|
| type | const | cancelled |
| value | bool | True to cancel the event. |
hostPHID
hostPHID
Change the host of the event.
| Key | Type | Description |
|---|---|---|
| type | const | hostPHID |
| value | phid | New event host. |
inviteePHIDs
inviteePHIDs
Change invited users.
| Key | Type | Description |
|---|---|---|
| type | const | inviteePHIDs |
| value | list<phid> | New event invitees. |
description
description
Update the event description.
| Key | Type | Description |
|---|---|---|
| type | const | description |
| value | string | New event description. |
icon
icon
Change the event icon.
| Key | Type | Description |
|---|---|---|
| type | const | icon |
| value | string | New event icon. |
isRecurring
isRecurring
Make the event recurring.
| Key | Type | Description |
|---|---|---|
| type | const | isRecurring |
| value | bool | Mark the event as a recurring event. |
frequency
frequency
Change the event frequency.
| Key | Type | Description |
|---|---|---|
| type | const | frequency |
| value | string | New event frequency. |
until
until
Change when the event repeats until.
| Key | Type | Description |
|---|---|---|
| type | const | until |
| value | epoch | New final event time. |
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. |
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://we.phorge.it/ --conduit-token <conduit-token> -- calendar.event.edit
$ curl https://we.phorge.it/api/calendar.event.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://we.phorge.it/');
$client->setConduitToken($api_token);
$result = $client->callMethodSynchronous('calendar.event.edit', $api_parameters);
print_r($result);
Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0