---
updatedAt: 2026-09-02T15:51:56.000Z
agentTools:
  siteIndex: https://developer.n-able.com/llms.txt
  projectIndex: https://developer.n-able.com/n-able-cove/llms.txt
---

# Authorization

Authorization in JSON-RPC API

API access requires authorization.

Create an API user in the Cove Data Protection Management Console, then use the generated token to authorize API requests. See the <Anchor target="_blank" href="https://documentation.n-able.com/covedataprotection/USERGUIDE/documentation/Content/service-management/console-new/users.htm">user management</Anchor> section in the main User Guide for detailed information on managing users.

## Add API Users

<Anchor target="_blank" href="https://documentation.n-able.com/covedataprotection/USERGUIDE/documentation/Content/service-management/console-new/user-management/add-user.htm">Create API users</Anchor> for your company or your customers from the Cove Management Console.

## Visa (session token)

In a response to your authorization request (Login), you will get a visa. This is a required parameter for all further requests. The visa stays valid for 15 minutes.

<Callout icon="📘" theme="info">
  Each response contains a new visa. You can use visas from previous calls to keep the visa chain uninterrupted. If the interval between service calls exceeds 15 minutes, you will need to repeat the Login request and start a new visa chain.
</Callout>

## Required parameters

| Parameter | Description                                       | Type/Supported values |
| --------- | ------------------------------------------------- | --------------------- |
| partner   | The name of the customer you want to log in under | std::string String    |
| username  | Your email address for access to the service      | std::string String    |
| password  | Your password for access to the service           | std::string String    |

### Sample request

```json
{
    "jsonrpc":"2.0",
    "method":"Login",
    "params":{
	    "partner":"Smart Telecom Inc.",
	    "username":"admin@smart-telecom.net",
	    "password":"sec1234!6"
    },
    "id":"1"
}
```

### Sample response

```json
{
    "id": "1",
    "jsonrpc": "2.0",
    "result": {
	"result": {
		"EmailAddress": "admin@smart-telecom.net",
		"FirstLoginTime": 1464945879,
		"FirstName": "Christine",
		"Flags": [
		    "AllowApiAuthentication"
		],
		"FullName": "Smith",
		"Id": 50193,
		"LastLoginTime": 1512383091,
		"Name": "admin@smart-telecom.net",
		"PartnerId": 33491,
		"Password": null,
		"PhoneNumber": "",
		"RoleId": 1,
		"Title": "Reseller",
		"TwoFactorAuthenticationStatus": "Enabled"
	}
    },
    "visa": "{{visa}}"
}
```