Attachment

Representation of an attachment object. An example JSON representation looks like this:

{
    "name" : "MyPicture.png",
    "doUpload" : true,
    "type" : "attachment",
    "size" : 7971,
    "contentType" : "img/png",
    "url" : "http://mydomain.com/spreadsheets/MyPicture.png",
    "id" : "1074"
 }

Examples:

Create Document with an Attachment

POST to /contents creates a new document. The server will obtain the files specified in the attachments array and store them as attachments of the new content. The minimum set of fields you must include (to create a document and upload an attachment) are:

 {
  "content":
      {
      "type": "text/html",
      "text": "<body><p>Some interesting text</p></body>"
      },
  "subject": "New Document",
  "type": "document",
  "attachments": [ {
      "doUpload": true,
      "url": "http://www.mysite.com/images/cat.jpg"
      } ]
  }

Create Document with an Attachment using multipart/form-data

POST to /contents creates a new document. Files included in the multipart/form-data request will be stored as attachments of the new content. The request must include a JSON part whose content type is "application/json" and a part for each attached file whose content type corresponds to the type of file and the part name is anything that you want (except for the word "json"). The minimum set of fields you must include (to create a document) are:

 {
  "content":
      {
      "type": "text/html",
      "text": "<body><p>Some interesting text</p></body>"
      },
  "subject": "New Document",
  "type": "document"
  }

The following rules govern updating of attachments:

If attachment block is not there, then Jive will not make any changes to attachments associated with content
If attachment block is empty, then Jive will delete all attachments associated with content
If attachment block is present, then Jive will replace attachments associated with content

Fields

Field	Type	Mode †	Description
`contentType`	`String`	required	The content type of this attachment.
`doUpload`	`Boolean`	required	An indicator of whether an attachment is new and should be uploaded.
`id`	`String`	read-only	Identifier (unique within an object type and Jive instance) of this object. This field is internal to Jive and should not be confused with contentID or placeID used in URIs.
`name`	`String`	optional	Filename of this attachment.
`resources`	`Object`	read-only	Resource links (and related permissions for the requesting person) relevant to this object.
`size`	`Integer`	read-only	The size (in bytes) of this attachment.
`status`	`String`	read-only	Published status of this content object. `incomplete` - Content object is in draft mode `awaiting moderation` - Content object is waiting for moderation by an approver `rejected` - Content object has been rejected for publication by an approver `published` - Content object has been published
`url`	`String`	required	The URL to retrieve the binary content of this attachment.
`followed`	`Boolean`	read-only	Whether the current user is following this object. Availability: Will be present only for object types that support being followed.

Resources

Resource	Method	Description
`self`	`GET`	Return an updated version of this attachment.
`self`	`DELETE`	Delete this attachment.

Attachment

Examples:

Create Document with an Attachment using multipart/form-data

Fields

Availability:

Resources