If you can’t find an operation you need in our primary reference documents, check our legacy API documents. The legacy documents contain information on all the services, but it is presented differently, and with a bit less detail.
Refer to the sections below for information on using the legacy documents.
To find out what services and operations are available, as well as the parameters they support:
Change it to:
You will see a list of available services.
Certain services substitute security or billing for services in the URL outlined above (e.g. https://sb1.replicon.com/security/help/all).
Each service includes several operations.
While building your application, you may want to test that you have formatted the field values and the JSON data correctly.
When using the test interface, keep in mind you are editing your organization’s live data. If you’d like to set up a sandbox instance for testing, please contact Replicon Support.
To confirm that you’re using valid data and have identified all the required fields:
This tab shows all the supported fields for the operation, and their types.
The results display below the tabs. If the fields are correct, you will see a Success message.
You can also populate the Fields tab using JSON data you’ve entered on the Raw tab, by clicking To Fields, located in the lower, right-hand corner of the Raw tab.
To test the JSON data:
The result displays below the tabs.
If you are unsure how to format the JSON data, you can automatically create JSON data based on the values entered in the Fields tab.
To automatically generate JSON data:
The text area will be automatically populated with the JSON data for the field values.
To set the Fields tab based on the JSON data you’ve entered in the Raw tab, click the To Fields button.
URIs (Uniform Resource Identifiers) are labels used in Replicon operations to identify specific resources of various types (e.g. projects, users, etc). Two types of URIs exist in Replicon:
These URIs are pre-defined by Replicon, and are unchanging. They are used to identify set resources in Replicon, such as cost types. Static URIs use the namespace Urn:replicon and take this format:
Urn:replicon:<object type>:<pre-defined option name>
These URIs identify resources defined by the customer, like project names. Tenant-scoped URIs use the namespace Urn:replicon-tenant, and match this pattern:
Urn:replicon-tenant:<company ID>:<object type>:<object ID>
Or, for older URIs, the company ID could be based on the company’s name.
If you need to reference a URI programmatically for a single item, use the Create operation for that item, which will return the URI for the new item.
To obtain the URI for multiple items, use the GetAll operation for that type of data. This will return a list of all items of that type and their URIs.
If you don’t need to obtain the URI programmatically, you can use the Fields tab to find the URI:
All of the items of that type are listed in a drop-down, with their display name.
The URI for the selected item displays.