REST API Reference > Customer Managed REST API > Calling APIs through the proxy

Calling APIs through the proxy

You send API requests in a Customer Managed environment through the Secure Agent proxy.

All requests sent through /rm/<product-api-path> automatically forward to the appropriate backend service on the Secure Agent. Requests and responses are relayed verbatim.

You can use the following methods in your API calls: GET, POST, PUT, DELETE, PATCH

Before you can call APIs, ensure that you've met the following conditions:

•You have obtained a token from the log in step. Add this token in the RM-USER-TOKEN header. For more information on obtaining the token, see Logging in.
•You have a role that allows access to Customer Managed Secure Agent APIs.

API call

Use the appropriate method with this API call:

<METHOD> https://<agent-host>:9443/rm/<api-path>
RM-USER-TOKEN: <token>

Examples

The following is a curl example using GET:

curl -sk -X GET https://<agent-host>:9443/rm/product1/api/v2/startJob \
-H "RM-USER-TOKEN: <token>"

The following is a curl example using POST:

curl -X POST ‘https://<agent host>:9443/rm/saas/api/v2/job’ \
  -H ‘Content-Type: application/json’ \
  -H ‘RM-USER-TOKEN: <offline user jwt>’ \
  -d ‘{
    “taskId”: “01C08X0Z000000000003",
    “@type”: “job”,
    “taskType”: “MTT”
  }’ (edited)

The following is a Postman version of the above curl example:

Request

{
"taskId": "01C08X0Z000000000003",
"@type": "job",
"taskType": "MTT"
}

Response

{
"@type": "job",
"taskId": "01C08X0Z000000000003",
"taskType": "MTT",
"runId": 1,
"runInParallel": false
}