POST V1 ems/experimentFactors/formulationLists

Adds a formulation list to an Experiment.

Authentication

This endpoint requires the api-username and api-usertoken headers for authentication.

Request Information

Parameters

NameDescriptionAdditional information
experimentFmlList 
Object describing the Formulation List to add to the Experiment:
            
  • ExperimentId - the ID of the Experiment to add the Formulation List to.
  • Name - the name of the Formulation List to add to the Experiment.
    		•

    Define this parameter in the request body.

    Example Request

    To add a Formulation List with Name Formulation List 1 to an Experiment with ID 1234, make the following API call:

    POST /ems/experimentFactors/formulationLists

    and put the following content in the request body:

    ExperimentId=1234&ListName=Formulation List 1

    Request body formats

    application/json, text/json

    Sample: 
    {
  "ExperimentId": 123,
  "Name": "Formulation List 1"
}

    application/xml, text/xml

    Sample: 
    <FormulationList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Unilever.Urdps.Hts.EmsApi.EntityRepresentations.Request.V1">
  <ExperimentId>123</ExperimentId>
  <Name>Formulation List 1</Name>
</FormulationList>

    application/x-www-form-urlencoded

    Sample: 
    ExperimentId=123&Name=Formulation List 1

    Request Detail

    This request does not currently support specifying an Amounts List for the Formulation List.
    This request should be made with the Content-Type header set to 'application/x-www-form-urlencoded', 'application/json' or 'application/xml'.
    This endpoint requires the api-username and api-usertoken headers to be present. If these headers are not present, a 401 (Unauthorized) response will be returned.

    Response Information

    HTTP Status Codes

    Status CodeMeaning
    201 (Created) The request has completed successfully. The ID of the experiment condition will be contained in the response.
    400 (Bad Request) The data in the request body was invalid. The nature of the error will be indicated in the Response content.
    401 (Unauthorized) The user has not been authorised.
    Please ensure that the client provides the api-username and api-usertoken headers.
    404 (Not Found) The Experiment with the specified ID could not be found or has been closed.
    Ensure the ID has been correctly specified.
    403 (Forbidden) The user does not have permission to access the specified experiment.
    Please use EMS to add the user to the experiment access control list.
    503 (ServiceUnavailable) EMS is currently unavailable.
    Please try again later or contact a system administrator to ask when EMS will be back online.