Retrieve a taxonomy term
/products/{product_id}/taxonomies/{taxonomy_id}/terms/{taxonomy_term_id}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.
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
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/products/string/taxonomies/string/terms/string"{ "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" }}Create a taxonomy term POST
Creates a term in a taxonomy. Requires the `taxonomies.update` permission. The optional `image` field accepts the ID of a file previously uploaded to the account. Terms cannot be created in taxonomies of replicated products. Attempts to do so return `403 Forbidden` with the `replica_readonly` error code.
Update a taxonomy term PATCH
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.