REST API Reference > Logging in
  

Logging in

You can use this resource to log in to the Secure Agent API in a Customer Managed runtime environment.
Most proxy APIs require a JWT, which you obtain by calling the login endpoint. No client certificate is required.

POST Request

To log in, use the following API call:
POST https://<agent-host>:9443/rm/api/v2/login
Content-Type: application/json
Use the following attributes in the request body:
{
"username": "jdoe@example.com",
"password": "s3cr3t"
}
The following is a login example using curl:
curl -sk -X POST https://<agent-host>:9443/rm/api/v1/login \
-H "Content-Type: application/json" \
-d '{"username":"jdoe@example.com","password":"s3cr3t"}'
The following table describes the attributes:
Field
Type
Required
Description
username
String
Yes
IDMC user name for the organization that you want to log in to.
password
String
Yes
The user's configured Customer Managed Secure Agent API password.
This is not the IDMC password.

POST Response

Returns the user object if the request is successful. Returns the error object if errors occur.
The following is a sample successful response:
{
"token": "eyJhbGciOiJIUzI1NiJ9...",
"expiresAt": "2025-06-01T12:00:00Z"
}
The response includes a token that you need to include in the RM-USER-TOKEN header of all subsequent REST API calls through the proxy. For more information, see .Calling APIs through the proxy