Replace lesson taxonomy terms

PUT/products/{product_id}/lessons/{lesson_id}/taxonomy-terms

Replaces the complete set of taxonomy terms assigned to the lesson with the terms in term_ids. Send an empty array to remove all terms. Every term must belong to a taxonomy of the same product.

Only lessons in products with the blog format support taxonomies. For products in other formats, the API returns format_unsupported and nothing is saved. Replicated lessons are read-only, and requests to change them return replica_readonly.

Send the lesson's current ETag in the If-Match header to avoid overwriting a newer version.

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

product_id*string
lesson_id*string

Header Parameters

If-Match?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/products/string/lessons/string/taxonomy-terms" \  -H "Content-Type: application/json" \  -d '{    "term_ids": [      "string"    ]  }'
{  "data": {    "lesson_id": "string",    "object": "lesson_taxonomy_terms",    "terms": [      {        "taxonomy_id": "string",        "term_id": "string"      }    ]  }}