Use this endpoint to retrieve (GET), update (PUT), or DELETE an existing MyLibrary folder.
Click a method to view its documentation
Privileges required : contacts:lists:write
PUT: Update the name, status of the ContactList specified by the
listId
path parameter. Performing a PUT overwrites all existing properties for the contactlist resource; any properties left blank or not included in the call will delete those property values prior to the call.
Privileges required : mylibrary:folder:update
Use PUT to modify the following properties for a folder specified by
folderId
path parameter:
name
parent_id
parent_id
to 0
Privileges required : mylibrary:file:update
Use a PUT call to update the following for a file (specified using the
fileId
path parameter):
name
folder_id
to specify the destination folder.
Privileges required : campaign:write
Update an existing event by using the
eventId
path parameter.
Privileges required : campaign:write
Update an existing event item; specify the event and the item using the
eventId
and
itemId
path parameters.
Privileges required : campaign:write
Update an existing promocode for an event; specify the code and event using the
eventId
and
promocodeId
path parameters.
Privileges required : campaign:write
Update an existing fee (specify using
feeId
) for an event specified by
eventId
.
Privileges required : campaign:write
Update an existing item attribute by specifying the
eventId
,
itemId
, and
attributeId
path parameters. Include the attribute name and description in the JSON request body.
NOTE: You cannot change an attribute name once any have been sold to or claimed by event registrants.
Privileges required : campaign:activate
Update the schedule for an email campaign using the
scheduleId
and
campaignId
path parameters.
Privileges required : campaign:create
Update an existing email campaign message specified by the
campaignId
path parameter. For campaigns with a template_type = CUSTOM, all editable fields are available for updating. If template_type = STOCK, the following fields are not available for edit (read-only):
These fields can only be updated using the Constant Contact user interface.
NOTE: There are several campaign properties that are optional by default, but become REQUIRED once another property is used. See Structure table below for specific properties.
PUT: https://api.constantcontact.com/v2/library/folders/{folderId} |
|||
name |
type |
default |
description |
---|---|---|---|
api_key |
query |
|
REQUIRED; The API key for the application |
folderId |
path |
|
Specifies the folder to Update |
include_payload |
query |
TRUE |
Determines if updated folder's JSON payload is returned :
|
- {
- "name":"Documents2",
- "parent_id":"0"
- }
code |
description |
---|---|
200 |
Folder was successfully updated |
204 |
Folder was successfully updated, no data returned |
400 |
Either JSON was malformed or there was a data validation error |
401 |
Authentication failure |
404 |
A folder with specified ID not found |
406 |
Unsupported accept header value, must be application/json |
409 |
A folder with that name at this level already exists |
415 |
Unsupported content-type in the header, must be application/json |
500 |
Internal server error occurred |
property |
type (max length) |
description |
---|
- {
- "id":"-4",
- "name":"Documents2",
- "level":1,
- "children":[{
- "id":"-10",
- "name":"market_studies",
- "level":2,
- "children":[],
- "item_count":0,
- "parent_id":"-4",
- "modified_date":"2013-06-24T13:12:10.000-04:00",
- "created_date":"2013-06-05T09:31:55.000-04:00"
- }],
- "item_count":1,
- "parent_id":"0",
- "modified_date":"2013-06-24T13:12:10.000-04:00",
- "created_date":"2013-06-05T09:31:55.000-04:00"
- }