Rollback Component

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

import requests

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

response = requests.post(url)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}")
  .asString();

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}

import requests

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

response = requests.post(url)

print(response.text)

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))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{id}/rollback/{version}")
  .asString();

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

organizationId

string

required

Organization ID

projectId

string

required

Project ID

string

required

Component ID

version

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();

List Component Versions Update Component Status

​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