Rollback Component

curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

POST

app

organizations

{organizationId}

projects

{projectId}

components

{id}

rollback

{version}

Rollback Component

curl --request POST \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}

const options = {method: 'POST'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Path Parameters

string

required

Organization ID

string

required

Project ID

string

required

Component ID

number

required

Target version number to rollback to

Request Body

No request body required.

Behavior

Rollback creates a new working copy using the content from the specified version:

The original version remains unchanged
All package references are preserved
The component status becomes modified
The working copy will receive a new version number when published in a package

Rollback does not modify or delete any existing versions. It creates a working copy based on historical content that can be published as a new version.

Response

Returns the Component object with modified status.

{
  "id": "c123",
  "name": "ProductCard",
  "status": "modified",
  "version": null,
  "lastPublishedVersion": 3,
  "content": "// Content from version 2\nconst metadata = () => ({...});",
  "compiled": "...",
  "schema": {...},
  "metadata": {
    "rolledBackFrom": 2,
    "rolledBackAt": "2024-03-22T10:00:00Z",
    "rolledBackBy": "user123"
  },
  "createdAt": "2024-03-20T10:00:00Z",
  "updatedAt": "2024-03-22T10:00:00Z"
}

Error Responses

Version Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Component version 5 was not found"
  }
}

Component Not Found

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Component not found"
  }
}

Code Examples

curl -X POST "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123/rollback/2" \
  -H "Authorization: Bearer YOUR_JWT"

const response = await fetch(
  'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123/rollback/2',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_JWT'
    }
  }
);

const component = await response.json();

Getting Started

API Basics

Organizations

Projects

Saved Searches

Folders

Components

Component Assets

Collections

Packages

Draft Packages

Content Types

Content

Assets

Asset Searching

Tags

Roles

API Keys

Rollback Component

Path Parameters

Request Body

Behavior

Response

Error Responses

Version Not Found

Component Not Found

Code Examples

​Path Parameters

​Request Body

​Behavior

​Response

​Error Responses

​Version Not Found

​Component Not Found

​Code Examples

Path Parameters

Request Body

Behavior

Response

Error Responses

Version Not Found

Component Not Found

Code Examples