Resource identification
Last updated: 2025-03-20Contributors
Edit this page
The table below describes properties that are supported by most of the API resources and used for identification purposes.
| Parameter | Type | Description |
|---|---|---|
id |
string | Internal unique identifier of a resource. This property usually exists in resources that support retrieval/update/deletion of a single record of a particular type. Depending on a resource it can hold either an integer or a string value. The resource ID is also passed as a path parameter in the URI |
uri |
URI string | Canonical URI of a resource. This URI might not be the same as the one that was used to retrieve this resource information. For example, if a resource was accessed by the URI containing simplified syntax with the tilde (~) characters, the canonical URI will also contain real identifiers. In most cases, the URI contains an ID value embedded as a path parameter. Please note that the most of the newer RingCentral APIs do not return uri attribute |
A similar convention is used when one resource refers to another. For example, a direct phone number returned by the API may contain a link to the extension it is assigned to in the following property:
"extension":
{
"id": 234244008,
"uri": ".../account/405884008/extension/234244008"
}