0% found this document useful (0 votes)
2 views2 pages

Repository API

The POST Repository API allows companies to register new content into the Repository using a REST POST request over HTTPS. It requires parameters such as CompanyId, ContentType, ContentId, Name, Description, Category, VendorId, and IntegrationKey, with specific formatting for XML or JSON. An example of a typical POST submission and its response is provided, demonstrating the structure of the request and expected output.

Uploaded by

avengerthor52
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
2 views2 pages

Repository API

The POST Repository API allows companies to register new content into the Repository using a REST POST request over HTTPS. It requires parameters such as CompanyId, ContentType, ContentId, Name, Description, Category, VendorId, and IntegrationKey, with specific formatting for XML or JSON. An example of a typical POST submission and its response is provided, demonstrating the structure of the request and expected output.

Uploaded by

avengerthor52
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 2

7/15/24, 5:58 PM

POST Repository API (Create)


TABLE OF CONTENTS
Parameters
Example
ADDITIONAL INFO
API Explorer
General Information

The POST Repository API registers new content from a company account into the Repository.

This API is available via SSL-secured HTTPS connection on the Cloud using the REST POST verb.
The format query string parameter controls the desired response format. Specify either XML or JSON.

/api/v2/repository?format=xml/json

You may use either JSON or XML formats in your POST request.
You indicate this by setting the ContentType HTTP header as "application/json" or "application/xml".
If no ContentType is specified, XML format is assumed.

All XML formatted requests must specify the following XML namespace in the data source root element:
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"

Parameters
The POST verb for the Repository API allows you to register new content from a company account.
The required and optional parameters for a POST call to the Repository API are outlined below.

Name Type Description Required


Your unique Company ID is found on the Organization Setup page of the
CompanyId Integer ✓
secure website.
ContentType String The type of content for this Repository item. ✓
The unique identifier of the content for this Repository item. For Screen
ContentId String ✓
and Doc content, this identifier tracks the current Published version.
Name String The Repository item's name. ✓
Description String The Repository item's description. ✓
Category String The Repository item's category type. ✓
Keywords String The Repository item's keywords.
Your unique Vendor account identifier.
VendorId Integer ✓*
*Required if the account resides under a Master Vendor account.
MasterId Integer Your unique Enterprise Toolkit account identifier. ✓*

1/2
7/15/24, 5:58 PM

*Required if the account resides under a Master Enterprise account with


EntToolKit enabled.
Your unique Integration Key is found on the Organization Setup page of
IntegrationKey String ✓
the secure website.

Example
Given that the API is REST-based, you can access the API directly via your web browser to test or by using the Postman
API Platform.

Below is an example of a typical POST submission to this API endpoint in JSON.

Request URL
https://secure.formsonfire.com:443/api/v2/repository

Request Body
{
"CompanyId": 6XXXX,
"ContentType": "Screen",
"ContentId": "36cXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Name": "Job Order TEST",
"Description": "TEST Description text",
"Category": "General",
"Keywords": "",
"VendorId": 6XXXX,
"IntegrationKey": "995XXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Response Body
{
"RepositoryItem": {
"Id": "f31XXXXXXXXXXXXXXXXXXXXXXXXX",
"CompanyId": 6XXXX,
"ContentType": "Screen",
"ContentId": "36cXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Name": "Job Order TEST",
"Description": "TEST Description text",
"Category": "General",
"Keywords": ""
}
}

Response Code
200

2/2

You might also like