Skip to main content
POST
/
api
/
v1
/
tags
/
{id}
/
listings
Apply tag to listings
curl --request POST \
  --url https://api.example.com/api/v1/tags/{id}/listings \
  --header 'Content-Type: application/json' \
  --data '
{
  "listingIds": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "workspaceID": "<string>",
  "listingIds": [
    [
      "<string>"
    ]
  ],
  "description": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://ota-docs.calry.app/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
id
string
required

ID of the tag to apply

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json

Array of listing IDs to which the tag should be applied

​
listingIds
string[]
required

Response

Tag applied to listings successfully, returns updated tag with listings

​
id
string
required

Unique identifier of the entity

​
createdAt
string<date-time>
required

Date and time when the entity was created

​
updatedAt
string<date-time>
required

Date and time when the entity was last updated

​
name
string
required

Name of the tag

​
workspaceID
string
required

ID of the workspace the tag belongs to

​
listingIds
string[][]
required

Listings associated with this tag

​
description
string

Optional description of the tag