Update a taxonomy term
/products/{product_id}/taxonomies/{taxonomy_id}/terms/{taxonomy_term_id}Updates the name and image of a taxonomy term. Omitted fields remain unchanged; setting image to null removes the image. image accepts the ID of a file previously uploaded to the account.
Send the ETag returned by the retrieve operation in the If-Match header to avoid overwriting a newer version.
Terms of replicated products are read-only. Attempts to update them return 403 Forbidden with the replica_readonly error code.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Header Parameters
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
curl -X PATCH "https://example.com/products/string/taxonomies/string/terms/string" \ -H "Content-Type: application/json" \ -d '{}'{ "data": { "created_at": "2019-08-24T14:15:22Z", "id": "string", "image": "string", "lessons_count": 0, "name": "string", "object": "taxonomy_term", "revision": "string", "taxonomy_id": "string", "updated_at": "2019-08-24T14:15:22Z" }}Retrieve a taxonomy term GET
Retrieves a taxonomy term by its public ID. The response includes an `ETag` representing the current revision. Send this value in the `If-Match` header when updating or deleting the term to avoid overwriting a newer version.
Delete a taxonomy term DELETE
Moves the term to the trash and removes it from every lesson it was assigned to. Send the `ETag` returned by the retrieve operation in the `If-Match` header to avoid deleting a term that has changed since it was retrieved. Terms of replicated products are read-only and cannot be deleted. Attempts to delete them return `403 Forbidden` with the `replica_readonly` error code.