Deprecations

NICo REST API maintains backward compatibility with the previous versions. Any breaking changes are announced using deprecation API objects.

Deprecation API Object

A deprecation API object is a JSON object that contains the details of a particular deprecation in the API. It is used to announce deprecations to clients of the API.

Attribute Deprecation

When an attribute of an API object is being deprecated:

• Each API object that contains the deprecated attribute will include a deprecations attribute containing an array of deprecation API objects
• When an attribute is being deprecated, only the attribute field will be included in the deprecation API object

1
{
2
    "id": "123e4567-e89b-12d3-a456-426614174000",
3
    "name": "test-object",
4
    "description": "Test object",
5
    "status": "Pending",
6
    "deprecations": [
7
        {
8
            "attribute": "displayName",
9
            "replacedBy": "orgDisplayName",
10
            "takeActionBy": "2026-06-08T00:00:00Z",
11
            "notice": "`displayName` has been deprecated in favor of `orgDisplayName`. Please take action prior to the specified date"
12
        }
13
    ]
14
}

Endpoint Deprecation

When an API endpoint is being deprecated:

• Each API endpoint will include a deprecations attribute containing an array of deprecation API objects
• When an endpoint is being deprecated, only the endpoint field will be included in the deprecation API object

1
{
2
    "id": "123e4567-e89b-12d3-a456-426614174000",
3
    "name": "test-endpoint",
4
    "description": "Test endpoint",
5
    "status": "Pending",
6
    "deprecations": [
7
        {
8
            "endpoint": "POST /org/:orgName/nico/infrastructure-provider",
9
            "takeActionBy": "2026-06-08T00:00:00Z",
10
            "notice": "`POST /org/:orgName/nico/infrastructure-provider` has been deprecated. Please take action prior to the specified date"
11
        }
12
    ]
13
}

If a deprecated attribute/endpoint or query param has no replacement, the replacedBy field will be omitted from the response.

Query Param Deprecation

When a query param is being deprecated:

• Each API endpoint that accepts the query param will include a deprecations attribute containing an array of deprecation API objects
• When a query param is being deprecated, only the queryParam field will be included in the deprecation API object

1
{
2
    "id": "123e4567-e89b-12d3-a456-426614174000",
3
    "name": "test-query-param",
4
    "description": "Test query param",
5
    "status": "Pending",
6
    "deprecations": [
7
        {
8
            "queryParam": "includeUsageStats",
9
            "replacedBy": "includeUsage",
10
            "takeActionBy": "2026-06-08T00:00:00Z",
11
            "notice": "`includeUsageStats` has been deprecated in favor of `includeUsage`. Please take action prior to the specified date"
12
        }
13
    ]
14
}

Guidance for Users

If the deprecated item is an attribute that belongs to a request object used for create/update API endpoints:

• If a new attribute is introduced, either the new or deprecated attribute can be specified in request until expiry date
• If both new and deprecated attributes are specified in request data at the same time, an HTTP 400 response is returned informing preference for the new attribute
• Once the take action by date has passed and the deprecated attribute is included in create/update request, an HTTP 400 response is returned informing that the attribute has been deprecated

Deprecation notices continue to be returned for one more release cycle after the take action by date.

Active Deprecations

Endpoints that have deprecations will be grouped here. Following deprecations are in effect:

• Currently there are no active deprecations

Recent Deprecations

Following deprecations were introduced in the recent past:

Site

• rackLevelAdministration capability attribute was deprecated in favor of flow and was removed on May 13th, 2026 0:00 UTC. Please use flow instead.
• isRackLevelAdministrationEnabled query parameter was deprecated in favor of isFlowEnabled and was removed on May 13th, 2026 0:00 UTC. Please use isFlowEnabled instead.