Documents / Entity

Add Document

This endpoint allows you to upload a Document based on JSON input.

You will only be able to upload a Document after first providing the Session Key. To know how you can obtain the Session Key, go to Authentication.

HEADERS

ParameterValueDescription
Content-Typeapplication/jsonLanguage in which all request and response bodies are encoded
Accept*/*Any data of whatever mime type is accepted
X-Session-KeyAUTH_TOKENThis field must be completed with the token obtained at the authentication

REQUEST BODY

AttributeTypeDescription
folderId (Required)StringSet the value -1 if you want to upload the Document in the Root folder, otherwise set the Folder's ID if you want to upload the file in a specific folder
name (Required)StringThe Document's name

RESPONSE

AttributeTypeDescription
locatorStringThe url you should upload the Document (check table below).
idIntegerThe ID assigned to the Document in the ForceManager Database

IMPORTANT: To upload your file to ForceManager storage you must do a PUT request with the binary data you want to upload and set the following headers:

AttributeValueDescription
Content-Typeapplication/octet-streamBinary file specification
Content-Length{file.size}It is the size of the file you are going to upload, in bytes

The endpoint to invoke with the PUT request is the one returned by this API call under the locator field.

RESPONSE CODES

StatusDescription
200 OKShows if operation succeeded
400 Bad RequestShows when an invalid request or the requested service is not available
post/documents

Request

  • Base URL: https://api.forcemanager.com/api/v4
  • URL: https://api.forcemanager.com/api/v4/documents
  • Auth: API key in header X-Session-Key

Headers

Acceptstring

Request body

folderIdstring
namestring

Response

Upload Document

Changes

No recorded changes to this operation across all 1 revision of this API.