contentful-management 3.11.0 → 3.12.0

data/spec/fixtures/vcr_cassettes/taxonomy_concept_scheme/find.yml

@@ -0,0 +1,78 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/organizations/4kQeJmhUWIKtNNmMkketza/taxonomy/concept-schemes/2hNivoHTKM4MbTM4519T5E
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/3.11.0; platform ruby/3.4.3; os macOS/24;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/5.0.1
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Connection:
+      - close
+      Content-Length:
+      - '617'
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35999'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Route:
+      - "/organizations/:organizationId/taxonomy/concept-schemes/:id"
+      Cache-Control:
+      - no-cache
+      Accept-Ranges:
+      - bytes
+      X-Content-Type-Options:
+      - nosniff
+      Server:
+      - Contentful
+      Contentful-Api:
+      - cma
+      Contentful-Upstream:
+      - taxonomy-service
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,CF-Context,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-Tag-Visibility,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature,X-Contentful-Source-Environment,X-Contentful-Team,X-Contentful-Parent-Id,x-contentful-validate-only,X-Contentful-Skip-UI-Draft-Validation,X-Contentful-Marketplace,X-Contentful-UI-Content-Auto-Save,cf-trace,X-Contentful-Comment-Body-Format,X-Contentful-Parent-Entity-Reference,X-Contentful-Include-Invocation-Metadata,X-Contentful-Async-Ai-Action,x-contentful-ai-actions-platform
+      Access-Control-Expose-Headers:
+      - Etag,x-contentful-request-id,x-contentful-ai-actions-ratelimit-reset
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,PATCH,OPTIONS
+      Access-Control-Max-Age:
+      - '1728000'
+      Date:
+      - Wed, 22 Oct 2025 13:07:06 GMT
+      X-Contentful-Request-Id:
+      - ffe98bdc-198d-4b52-8d3f-e276895ba69a
+      Strict-Transport-Security:
+      - max-age=15768000
+    body:
+      encoding: UTF-8
+      string: '{"sys":{"id":"2hNivoHTKM4MbTM4519T5E","type":"TaxonomyConceptScheme","createdAt":"2025-09-14T06:37:32.431Z","updatedAt":"2025-09-15T12:42:23.839Z","organization":{"sys":{"id":"4kQeJmhUWIKtNNmMkketza","type":"Link","linkType":"Organization"}},"createdBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"updatedBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"version":3},"uri":null,"topConcepts":[],"concepts":[{"sys":{"id":"greenSofas","type":"Link","linkType":"TaxonomyConcept"}}],"totalConcepts":1,"prefLabel":{"en-US":"Home
+        Products"},"definition":{"en-US":""}}'
+  recorded_at: Wed, 22 Oct 2025 13:07:06 GMT
+recorded_with: VCR 6.2.0

data/spec/fixtures/vcr_cassettes/taxonomy_concept_scheme/total.yml

@@ -0,0 +1,77 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/organizations/4kQeJmhUWIKtNNmMkketza/taxonomy/concept-schemes/total
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/3.11.0; platform ruby/3.4.3; os macOS/24;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/5.0.1
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Connection:
+      - close
+      Content-Length:
+      - '11'
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35999'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Route:
+      - "/organizations/:organizationId/taxonomy/concept-schemes/total"
+      Cache-Control:
+      - no-cache
+      Accept-Ranges:
+      - bytes
+      X-Content-Type-Options:
+      - nosniff
+      Server:
+      - Contentful
+      Contentful-Api:
+      - cma
+      Contentful-Upstream:
+      - taxonomy-service
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,CF-Context,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-Tag-Visibility,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature,X-Contentful-Source-Environment,X-Contentful-Team,X-Contentful-Parent-Id,x-contentful-validate-only,X-Contentful-Skip-UI-Draft-Validation,X-Contentful-Marketplace,X-Contentful-UI-Content-Auto-Save,cf-trace,X-Contentful-Comment-Body-Format,X-Contentful-Parent-Entity-Reference,X-Contentful-Include-Invocation-Metadata,X-Contentful-Async-Ai-Action,x-contentful-ai-actions-platform,X-Contentful-User-Id
+      Access-Control-Expose-Headers:
+      - Etag,x-contentful-request-id,x-contentful-ai-actions-ratelimit-reset
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,PATCH,OPTIONS
+      Access-Control-Max-Age:
+      - '1728000'
+      Date:
+      - Fri, 24 Oct 2025 08:29:42 GMT
+      X-Contentful-Request-Id:
+      - 5c6509d2-b4bb-41d4-b838-dc210807805d
+      Strict-Transport-Security:
+      - max-age=15768000
+    body:
+      encoding: UTF-8
+      string: '{"total":2}'
+  recorded_at: Fri, 24 Oct 2025 08:29:42 GMT
+recorded_with: VCR 6.2.0

data/spec/fixtures/vcr_cassettes/taxonomy_concept_scheme/update.yml

@@ -0,0 +1,155 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/organizations/4kQeJmhUWIKtNNmMkketza/taxonomy/concept-schemes/2hNivoHTKM4MbTM4519T5E
+    body:
+      encoding: UTF-8
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/3.11.0; platform ruby/3.4.3; os macOS/24;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/5.0.1
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Connection:
+      - close
+      Content-Length:
+      - '617'
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35999'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Route:
+      - "/organizations/:organizationId/taxonomy/concept-schemes/:id"
+      Cache-Control:
+      - no-cache
+      Accept-Ranges:
+      - bytes
+      X-Content-Type-Options:
+      - nosniff
+      Server:
+      - Contentful
+      Contentful-Api:
+      - cma
+      Contentful-Upstream:
+      - taxonomy-service
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,CF-Context,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-Tag-Visibility,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature,X-Contentful-Source-Environment,X-Contentful-Team,X-Contentful-Parent-Id,x-contentful-validate-only,X-Contentful-Skip-UI-Draft-Validation,X-Contentful-Marketplace,X-Contentful-UI-Content-Auto-Save,cf-trace,X-Contentful-Comment-Body-Format,X-Contentful-Parent-Entity-Reference,X-Contentful-Include-Invocation-Metadata,X-Contentful-Async-Ai-Action,x-contentful-ai-actions-platform
+      Access-Control-Expose-Headers:
+      - Etag,x-contentful-request-id,x-contentful-ai-actions-ratelimit-reset
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,PATCH,OPTIONS
+      Access-Control-Max-Age:
+      - '1728000'
+      Date:
+      - Wed, 22 Oct 2025 13:10:46 GMT
+      X-Contentful-Request-Id:
+      - 333db422-2961-49d0-a52d-34b1a7578a10
+      Strict-Transport-Security:
+      - max-age=15768000
+    body:
+      encoding: UTF-8
+      string: '{"sys":{"id":"2hNivoHTKM4MbTM4519T5E","type":"TaxonomyConceptScheme","createdAt":"2025-09-14T06:37:32.431Z","updatedAt":"2025-09-15T12:42:23.839Z","organization":{"sys":{"id":"4kQeJmhUWIKtNNmMkketza","type":"Link","linkType":"Organization"}},"createdBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"updatedBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"version":3},"uri":null,"topConcepts":[],"concepts":[{"sys":{"id":"greenSofas","type":"Link","linkType":"TaxonomyConcept"}}],"totalConcepts":1,"prefLabel":{"en-US":"Home
+        Products"},"definition":{"en-US":""}}'
+  recorded_at: Wed, 22 Oct 2025 13:10:46 GMT
+- request:
+    method: patch
+    uri: https://api.contentful.com/organizations/4kQeJmhUWIKtNNmMkketza/taxonomy/concept-schemes/2hNivoHTKM4MbTM4519T5E
+    body:
+      encoding: UTF-8
+      string: '[{"op":"add","path":"/prefLabel/en-US","value":"New Scheme Name"}]'
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/3.11.0; platform ruby/3.4.3; os macOS/24;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/json-patch+json
+      X-Contentful-Version:
+      - '3'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/5.0.1
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Connection:
+      - close
+      Content-Length:
+      - '619'
+      Content-Type:
+      - application/json; charset=utf-8
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35998'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '8'
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Route:
+      - "/organizations/:organizationId/taxonomy/concept-schemes/:id"
+      Cache-Control:
+      - no-cache
+      X-Content-Type-Options:
+      - nosniff
+      Server:
+      - Contentful
+      Contentful-Api:
+      - cma
+      Contentful-Upstream:
+      - taxonomy-service
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,CF-Context,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-Tag-Visibility,X-Contentful-User-Agent,X-Contentful-Enable-Alpha-Feature,X-Contentful-Source-Environment,X-Contentful-Team,X-Contentful-Parent-Id,x-contentful-validate-only,X-Contentful-Skip-UI-Draft-Validation,X-Contentful-Marketplace,X-Contentful-UI-Content-Auto-Save,cf-trace,X-Contentful-Comment-Body-Format,X-Contentful-Parent-Entity-Reference,X-Contentful-Include-Invocation-Metadata,X-Contentful-Async-Ai-Action,x-contentful-ai-actions-platform
+      Access-Control-Expose-Headers:
+      - Etag,x-contentful-request-id,x-contentful-ai-actions-ratelimit-reset
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,PATCH,OPTIONS
+      Access-Control-Max-Age:
+      - '1728000'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Wed, 22 Oct 2025 13:10:47 GMT
+      X-Contentful-Request-Id:
+      - 9ad5db54-aac3-4541-8ab9-e36b1c4a2f99
+      Strict-Transport-Security:
+      - max-age=15768000
+    body:
+      encoding: UTF-8
+      string: '{"sys":{"id":"2hNivoHTKM4MbTM4519T5E","type":"TaxonomyConceptScheme","createdAt":"2025-09-14T06:37:32.431Z","updatedAt":"2025-10-22T13:10:46.957Z","organization":{"sys":{"id":"4kQeJmhUWIKtNNmMkketza","type":"Link","linkType":"Organization"}},"createdBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"updatedBy":{"sys":{"id":"59Erm8D1JuuD273aXNb65T","type":"Link","linkType":"User"}},"version":4},"uri":null,"topConcepts":[],"concepts":[{"sys":{"id":"greenSofas","type":"Link","linkType":"TaxonomyConcept"}}],"totalConcepts":1,"prefLabel":{"en-US":"New
+        Scheme Name"},"definition":{"en-US":""}}'
+  recorded_at: Wed, 22 Oct 2025 13:10:47 GMT
+recorded_with: VCR 6.2.0

data/spec/lib/contentful/management/asset_spec.rb

@@ -370,6 +370,26 @@ module Contentful
             expect(asset.file.properties[:fileName]).to eq 'codequest.jpg'
           end
         end
+
+        it 'updates asset with concepts' do
+          vcr('asset/update_with_concepts') do
+            asset = subject.find('56PfMcxCLyzuXP3k7k0yL5')
+            concepts = [
+              {
+                'sys' => {
+                  'type' => 'Link',
+                  'linkType' => 'TaxonomyConcept',
+                  'id' => 'livingRoom'
+                }
+              }
+            ]
+            asset.update(_metadata: { concepts: concepts, tags: [] })
+            expect(asset._metadata[:concepts]).to be_a(::Array)
+            expect(asset._metadata[:concepts].first).to be_a(Contentful::Management::Link)
+            expect(asset._metadata[:concepts].first.id).to eq('livingRoom')
+            expect(asset._metadata[:concepts].first.link_type).to eq('TaxonomyConcept')
+          end
+        end
       end
       describe '#save' do
         it 'updated' do

data/spec/lib/contentful/management/content_type_spec.rb

@@ -6,6 +6,7 @@ module Contentful
   module Management
     describe ContentType do
       let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
+
       let(:space_id) { 'yr5m0jky5hsh' }
       let!(:client) { Client.new(token) }
       let(:content_type_id) { '5DSpuKrl04eMAGQoQckeIq' }
@@ -353,6 +354,27 @@ module Contentful
           end
         end
 
+        it 'updates content_type with metadata' do
+          vcr('content_type/update_with_metadata') do
+            content_type = subject.find('author')
+            metadata = {
+              taxonomy: [
+                {
+                  'sys' => {
+                    'type' => 'Link',
+                    'linkType' => 'TaxonomyConcept',
+                    'id' => 'newConcept'
+                  }
+                }
+              ]
+            }
+            content_type.update(_metadata: metadata)
+            expect(content_type._metadata[:taxonomy]).to be_truthy
+            expect(content_type._metadata[:taxonomy].first['sys']['id']).to eq 'newConcept'
+            expect(content_type._metadata[:taxonomy].first['sys']['linkType']).to eq 'TaxonomyConcept'
+          end
+        end
+
         it 'update with multiple locales' do
           vcr('content_type/entry/update_only_with_localized_fields') do
             space = client.spaces.find('v2umtz8ths9v')

data/spec/lib/contentful/management/entry_spec.rb

@@ -555,6 +555,27 @@ describe Contentful::Management::Entry do
         expect(p.fields).to match(expected)
       end
     end
+
+    it 'can update entry with concepts' do
+      vcr('entry/update_with_concepts') do
+        entry = subject.find('2aJVtypYfQajNbNN9TvEfd')
+        concepts = [
+          {
+            'sys' => {
+              'type' => 'Link',
+              'linkType' => 'TaxonomyConcept',
+              'id' => 'livingRoom'
+            }
+          }
+        ]
+        entry.update(_metadata: { concepts: concepts, tags: [] })
+        expect(entry._metadata[:concepts]).to be_a(::Array)
+        expect(entry._metadata[:concepts].first).to be_a(Contentful::Management::Link)
+        expect(entry._metadata[:concepts].first.id).to eq('livingRoom')
+        expect(entry._metadata[:concepts].first.link_type).to eq('TaxonomyConcept')
+      end
+    end
+
   end
 
   describe '#save' do
@@ -1255,4 +1276,4 @@ describe Contentful::Management::Entry do
       end
     end
   end
-end
+end

data/spec/lib/contentful/management/taxonomy_concept_scheme_spec.rb

@@ -0,0 +1,85 @@
+require 'spec_helper'
+require 'contentful/management/taxonomy_concept_scheme'
+require 'contentful/management/client'
+
+module Contentful
+  module Management
+    describe TaxonomyConceptScheme do
+      let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
+
+      let(:organization_id) { '4kQeJmhUWIKtNNmMkketza' }
+      let(:concept_scheme_id) { '2hNivoHTKM4MbTM4519T5E' }
+      let(:client) { Client.new(token, raise_errors: true) }
+
+      subject { client.taxonomy_concept_schemes(organization_id) }
+
+      describe '.find' do
+        it 'returns a Contentful::Management::TaxonomyConceptScheme' do
+          vcr('taxonomy_concept_scheme/find') do
+            concept_scheme = subject.find(concept_scheme_id)
+            expect(concept_scheme).to be_a Contentful::Management::TaxonomyConceptScheme
+            expect(concept_scheme.id).to eq concept_scheme_id
+            expect(concept_scheme.pref_label['en-US']).to eq 'Home Products'
+          end
+        end
+      end
+
+      describe '.all' do
+        it 'returns an array of taxonomy concept schemes' do
+          vcr('taxonomy_concept_scheme/all') do
+            schemes = subject.all
+            expect(schemes).to be_a(Contentful::Management::Array)
+            expect(schemes.first).to be_a(Contentful::Management::TaxonomyConceptScheme)
+          end
+        end
+      end
+
+      describe '.total' do
+        it 'returns the total number of concept schemes' do
+          vcr('taxonomy_concept_scheme/total') do
+            total = subject.total
+            expect(total).to be_a(Integer)
+          end
+        end
+      end
+
+      describe '.create' do
+        it 'creates a taxonomy concept scheme' do
+          vcr('taxonomy_concept_scheme/create') do
+            scheme = subject.create(
+              prefLabel: { 'en-US' => 'New Scheme' }
+            )
+            expect(scheme).to be_a(Contentful::Management::TaxonomyConceptScheme)
+            expect(scheme.pref_label['en-US']).to eq('New Scheme')
+          end
+        end
+      end
+
+      describe '#update' do
+        it 'updates a taxonomy concept scheme' do
+          vcr('taxonomy_concept_scheme/update') do
+            scheme = subject.find(concept_scheme_id)
+            updated_scheme = scheme.update([
+                                             { op: 'add', path: '/prefLabel/en-US', value: 'New Scheme Name' }
+                                           ])
+            expect(updated_scheme).to be_a(Contentful::Management::TaxonomyConceptScheme)
+            expect(updated_scheme.pref_label['en-US']).to eq('New Scheme Name')
+          end
+        end
+      end
+
+      describe '#destroy' do
+        it 'deletes a taxonomy concept scheme' do
+          vcr('taxonomy_concept_scheme/destroy') do
+            scheme = subject.find(concept_scheme_id)
+            result = scheme.destroy
+            expect(result).to be_truthy
+          end
+        end
+      end
+    end
+  end
+end
+
+
+

data/spec/lib/contentful/management/taxonomy_concept_spec.rb

@@ -0,0 +1,116 @@
+require 'spec_helper'
+require 'contentful/management/taxonomy_concept'
+require 'contentful/management/client'
+
+module Contentful
+  module Management
+    describe TaxonomyConcept do
+      let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
+
+      let(:organization_id) { '4kQeJmhUWIKtNNmMkketza' }
+      let(:concept_id) { '5KHXWlmxvntrrB09szapUp' }
+      let(:client) { Client.new(token) }
+
+      subject { client.taxonomy_concepts(organization_id) }
+
+      describe '.find' do
+        it 'returns a Contentful::Management::TaxonomyConcept' do
+          vcr('taxonomy_concept/find') do
+            concept = subject.find(concept_id)
+            expect(concept).to be_a Contentful::Management::TaxonomyConcept
+            expect(concept.id).to eq concept_id
+            expect(concept.pref_label['en-US']).to eq 'Sofas'
+          end
+        end
+      end
+
+      describe '.all' do
+        it 'returns an array of taxonomy concepts' do
+          vcr('taxonomy_concept/all') do
+            concepts = subject.all
+            expect(concepts).to be_a(Contentful::Management::Array)
+            expect(concepts.first).to be_a(Contentful::Management::TaxonomyConcept)
+          end
+        end
+      end
+
+      describe '.total' do
+        it 'returns the total number of concepts' do
+          vcr('taxonomy_concept/total') do
+            total = subject.total
+            expect(total).to be_a(Integer)
+          end
+        end
+      end
+
+      describe '.create' do
+        it 'creates a taxonomy concept' do
+          vcr('taxonomy_concept/create') do
+            concept = subject.create(
+              prefLabel: { 'en-US' => 'Bicycles' }
+            )
+            expect(concept).to be_a(Contentful::Management::TaxonomyConcept)
+            expect(concept.pref_label['en-US']).to eq('Bicycles')
+          end
+        end
+
+        it 'creates a taxonomy concept with a user-defined id' do
+          vcr('taxonomy_concept/create_with_id') do
+            concept = subject.create(
+              id: 'my-custom-id',
+              prefLabel: { 'en-US' => 'Custom Bicycles' }
+            )
+            expect(concept).to be_a(Contentful::Management::TaxonomyConcept)
+            expect(concept.id).to eq('my-custom-id')
+            expect(concept.pref_label['en-US']).to eq('Custom Bicycles')
+          end
+        end
+      end
+
+      describe '#update' do
+        it 'updates a taxonomy concept' do
+          vcr('taxonomy_concept/update') do
+            concept = subject.find(concept_id)
+            updated_concept = concept.update([
+                                               { op: 'add', path: '/prefLabel/en-US', value: 'New Label' }
+                                             ])
+            expect(updated_concept).to be_a(Contentful::Management::TaxonomyConcept)
+            expect(updated_concept.pref_label['en-US']).to eq('New Label')
+          end
+        end
+      end
+
+      describe '#ancestors' do
+        it 'returns an array of ancestor concepts' do
+          vcr('taxonomy_concept/ancestors') do
+            concept = subject.find('livingRoom')
+            ancestors = concept.ancestors
+            expect(ancestors).to be_a(Contentful::Management::Array)
+            expect(ancestors.first).to be_a(Contentful::Management::TaxonomyConcept)
+          end
+        end
+      end
+
+      describe '#descendants' do
+        it 'returns an array of descendant concepts' do
+          vcr('taxonomy_concept/descendants') do
+            concept = subject.find('greenSofas')
+            descendants = concept.descendants
+            expect(descendants).to be_a(Contentful::Management::Array)
+            expect(descendants.first).to be_a(Contentful::Management::TaxonomyConcept)
+          end
+        end
+      end
+
+      describe '#destroy' do
+        it 'deletes a taxonomy concept' do
+          vcr('taxonomy_concept/destroy') do
+            concept = subject.find(concept_id)
+            result = concept.destroy
+            expect(result).to be_truthy
+          end
+        end
+      end
+    end
+  end
+end