CalryOTA Docs
Listing

Set or clear the requesting tenant's search rank for a listing

Assigns a rank (1–100, 1 = shown first) to this listing for the requesting tenant's search results, or clears it with rank: null. Works for own and imported network listings alike; other tenants' results are unaffected.

PUT
/api/v1/listing/{id}/rank

Authorization

x-calry-api-key
x-calry-api-key<token>

In: header

Path Parameters

id*string

Unique identifier of the listing

Header Parameters

x-calry-tenant-id?string

Optional tenant ID to specify which tenant to operate as. If not provided, the default tenant will be used.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PUT "https://example.com/api/v1/listing/123e4567-e89b-12d3-a456-426614174000/rank" \  -H "Content-Type: application/json" \  -d '{    "rank": 2  }'
{
  "rank": 2
}
{
  "timestamp": "2025-03-05T11:45:49.631Z",
  "path": "<URL_PATH>",
  "message": "Authentication failed",
  "details": []
}
Empty