Put

Update an existing document
Parameters:
Name
Optional / Required
Data type
Description
Default
id
required
Integer
One of your document ids
​
title
required
String
A title for your document. Min. length 5 characters, max. length 255 characters
​
description
optional
String
A description for your document. Min. length 5 characters, max. length 2500 characters
​
category
optional
Integer
1, 2 or ... (A list of valid category ids: Document categories)
0 = None
language
optional
String
en, de or ... (A list of valid languages: Document languages)
en
tags
optional
String
A list of words seperated by comma (house,garden,balcony). Min. length 3 characters, max. length 30 characters. Allowed characters a-z and a space.
Autogenerated by tag service
visibility
optional
String
public, private, rprotected, pprotected, dprotected, webkiosk, appkiosk or webappkiosk (rprotected = protected by referrer, pprotected = protected by password, dprotected = protected by domain(s))
public
validity
optional
String
Valid from and / or valid until Examples: 2013-10-01T00:00:00-2013-10-30T23:59:59 (valid from 2013-10-01 00:00:00, valid until 2013-10-30 23:59:59) 2013-10-01T00:00:00- (valid from 2013-10-01 00:00:00-) -2013-10-30T23:59:59 (valid until -2013-10-30 23:59:59)
​
downloadable
optional
String
Allow users to download your source pdf file. y or n
n
recommended_magazines
optional
String
Show recommended magazines on Yumpu? y or n
y
social_sharing
optional
String
Show social sharing buttons on Yumpu. y or n
y
site_pageview
optional
String
Show document in single or double pageview. double or single
double
player_social_sharing
optional
String
Show social sharing buttons in Yumpu Player. y or n
y
player_download_pdf
optional
String
Show button "download pdf" in Yumpu Player. y or n
n
player_print_page
optional
String
Show button "print page" in Yumpu Player. y or n
n
player_branding
optional
String
Show Yumpu branding in Yumpu Player. y or n
y
player_sidebar
optional
String
Show a list of recommended documents in Yumpu Player. y or n
n
player_html5_c2r
optional
String
Activate HTML5 full screen on Yumpu. y or n
y
player_outer_shadow
optional
String
Drop shadow in Yumpu player. y or n
y
player_inner_shadow
optional
String
Shadow effects on pages. y or n
y
player_ga
optional
String
Activate Google Analytics tracking. A valid UA code from Google Analytics.
​
access_tags
optional
String
One or multiple access_tag ids (myid1 or myid1,myid2)
​
subscriptions
optional
String
One or multiple subscription ids (myid1 or myid1,myid2)
​
iap
optional
String
Enable In-App Purchase (y or n)
n
itc_product_id
optional
String
iTunes Product ID
​
curl
PHP
JavaScript
Java
Example:
curl -X PUT -H "X-ACCESS-TOKEN: YOUR_ACCESS_TOKEN" -d "id=20582984" -d "title=My new document title" "https://api.yumpu.com/2.0/document.json"
Example:
require_once('../yumpu.php');
$yumpu = new Yumpu();
$data = array(
    'id' => 20582984,  
    'title' => 'My new document title'
);
$putDocument = $yumpu->putDocument($data);
print_r($putDocument);
Example:
var yumpu = require('yumpu');
yumpu.setToken('yourToken');
var parameters = {
  id: '20582984',
  title: 'My new document title'
};
yumpu.putDocument(parameters, function(statusCode, document){
   console.log('Status: ' + statusCode);
   console.log(document);
});
Example:
Yumpu y = new Yumpu("your access token");
String[] params = {"id=20582984", "title=My new document title"};
System.out.println(y.putDocument(params));
Whatever language you are using, the result will be the same.
{
  "document": [
    {
      "id": 20582984,
      "create_date": "2016-09-13 09:13:15",
      "update_date": "2016-09-13 09:17:23",
      "url": "https://www.yumpu.com/de/document/view/55932706/new-title-2",
      "short_url": "https://www.yumpu.com/s/Ok8tEcVRDCsfAod0",
      "image": {
        "small": "https://img.yumpu.com/55932706/1/115x163/new-title.jpg",
        "medium": "https://img.yumpu.com/55932706/1/452x640/new-title.jpg",
        "big": "https://img.yumpu.com/55932706/1/1129x1600/new-title.jpg"
      },
      "language": "de",
      "title": "My new document title",
      "description": "",
      "pages": 3,
      "width": 452,
      "height": 640,
      "tags": [
        "suchparameter",
        "liefert",
        "google",
        "webseiten",
        "suchbegriff",
        "mehreren",
        "angezeigt",
        "beschreibung",
        "nutzwert",
        "treffer",
        "www.lukasbals.at"
      ],
      "embed_code": "<iframe width=\"512px\" height=\"384px\" src=\"https://www.yumpu.com/de/embed/view/CsdA9tSUlmyVvbNO\" frameborder=\"0\" allowfullscreen=\"true\" allowtransparency=\"true\"></iframe>",
      "settings": {
        "date_validity_from": "",
        "date_validity_until": "",
        "site_social_sharing": true,
        "privacy_mode": "public",
        "site_download_pdf": false,
        "site_recommended_magazines": true,
        "player_download_pdf": false,
        "player_print_page": false,
        "player_branding": true,
        "player_sidebar": false,
        "player_social_sharing": true,
        "player_google_analytics_code": "",
        "player_html5_c2r": true,
        "player_outer_shadow": true,
        "player_inner_shadow": true,
        "appkiosk_itc_product_id": "",
        "appkiosk_iap_sale_item": false,
        "magazine_premium_blurred": false,
        "magazine_premium_blurred_page_range": "",
        "magazine_page_teaser": false,
        "magazine_page_teaser_page_range": "",
        "magazine_page_teaser_url": "",
        "magazine_page_teaser_image_url": "",
        "magazine_acl_running": false,
        "player_zoom_factor": 2.5,
        "hotspoteditor_custom": false
      },
      "access_tags": false,
      "subscriptions": false
    }
  ],
  "state": "success",
  "status_code": 200,
  "completed_in": 0.8976
}

Post url

Delete

Last modified 1yr ago

Name	Optional / Required	Data type	Description	Default
id	required	Integer	One of your document ids
title	required	String	A title for your document. Min. length 5 characters, max. length 255 characters
description	optional	String	A description for your document. Min. length 5 characters, max. length 2500 characters
category	optional	Integer	1, 2 or ... (A list of valid category ids: Document categories)	0 = None
language	optional	String	en, de or ... (A list of valid languages: Document languages)	en
tags	optional	String	A list of words seperated by comma (house,garden,balcony). Min. length 3 characters, max. length 30 characters. Allowed characters a-z and a space.	Autogenerated by tag service
visibility	optional	String	public, private, rprotected, pprotected, dprotected, webkiosk, appkiosk or webappkiosk (rprotected = protected by referrer, pprotected = protected by password, dprotected = protected by domain(s))	public
validity	optional	String	Valid from and / or valid until Examples: 2013-10-01T00:00:00-2013-10-30T23:59:59 (valid from 2013-10-01 00:00:00, valid until 2013-10-30 23:59:59) 2013-10-01T00:00:00- (valid from 2013-10-01 00:00:00-) -2013-10-30T23:59:59 (valid until -2013-10-30 23:59:59)
downloadable	optional	String	Allow users to download your source pdf file. y or n	n
recommended_magazines	optional	String	Show recommended magazines on Yumpu? y or n	y
social_sharing	optional	String	Show social sharing buttons on Yumpu. y or n	y
site_pageview	optional	String	Show document in single or double pageview. double or single	double
player_social_sharing	optional	String	Show social sharing buttons in Yumpu Player. y or n	y
player_download_pdf	optional	String	Show button "download pdf" in Yumpu Player. y or n	n
player_print_page	optional	String	Show button "print page" in Yumpu Player. y or n	n
player_branding	optional	String	Show Yumpu branding in Yumpu Player. y or n	y
player_sidebar	optional	String	Show a list of recommended documents in Yumpu Player. y or n	n
player_html5_c2r	optional	String	Activate HTML5 full screen on Yumpu. y or n	y
player_outer_shadow	optional	String	Drop shadow in Yumpu player. y or n	y
player_inner_shadow	optional	String	Shadow effects on pages. y or n	y
player_ga	optional	String	Activate Google Analytics tracking. A valid UA code from Google Analytics.
access_tags	optional	String	One or multiple access_tag ids (myid1 or myid1,myid2)
subscriptions	optional	String	One or multiple subscription ids (myid1 or myid1,myid2)
iap	optional	String	Enable In-App Purchase (y or n)	n
itc_product_id	optional	String	iTunes Product ID