Catalogs endpoints
This document contains the endpoints for the Catalogs category.
Gets catalog cache
/api/v1/cache
Authorized
This endpoint returns all the remote catalog cache if any
Request examples
/v1/cache
Authorized
curl --location 'http://localhost/api/v1/cache'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/cache" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/cache"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes all catalog cache
/api/v1/cache
Authorized
This endpoint returns all the remote catalog cache if any
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
Request examples
/v1/cache
Authorized
curl --location 'http://localhost/api/v1/cache'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/cache" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/cache"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes catalog cache item and all its versions
/api/v1/cache/{catalogId}
Authorized
This endpoint returns all the remote catalog cache if any and all its versions
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
Request examples
/v1/cache/{catalogId}
Authorized
curl --location 'http://localhost/api/v1/cache/{catalogId}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/cache/{catalogId}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/cache/{catalogId}"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes catalog cache version item
/api/v1/cache/{catalogId}/{version}
Authorized
This endpoint deletes a version of a cache ite,
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
Request examples
/v1/cache/{catalogId}/{version}
Authorized
curl --location 'http://localhost/api/v1/cache/{catalogId}/{version}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/cache/{catalogId}/{version}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/cache/{catalogId}/{version}"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Gets all the remote catalogs
/api/v1/catalog
Authorized
This endpoint returns all the remote catalogs
Request examples
/v1/catalog
Authorized
curl --location 'http://localhost/api/v1/catalog'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/catalog" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Gets all the remote catalogs
/api/v1/catalog/{catalogId}
Authorized
This endpoint returns all the remote catalogs
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
Request examples
/v1/catalog/{catalogId}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/catalog/{catalogId}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Gets a catalog manifest version
/api/v1/catalog/{catalogId}/{version}
Authorized
This endpoint returns a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
Request examples
/v1/catalog/{catalogId}/{version}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/catalog/{catalogId}/{version}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Gets a catalog manifest version architecture
/api/v1/catalog/{catalogId}/{version}/{architecture}
Authorized
This endpoint returns a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Downloads a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/download
Authorized
This endpoint downloads a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/download
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/download'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Get , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/download" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/download"
method := "get"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Taints a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/taint
Authorized
This endpoint Taints a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/taint
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/taint'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/taint" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/taint"
method := "patch"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
UnTaints a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/untaint
Authorized
This endpoint UnTaints a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/untaint
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/untaint'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/untaint" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/untaint"
method := "patch"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
UnTaints a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/revoke
Authorized
This endpoint UnTaints a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/revoke
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/revoke'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/revoke" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/revoke"
method := "patch"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Adds claims to a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
This endpoint adds claims to a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
request
object
body
optional
Body
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims"
method := "patch"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Removes claims from a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
This endpoint removes claims from a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
request
object
body
optional
Body
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims"
method := "delete"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Adds roles to a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/roles
Authorized
This endpoint adds roles to a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
request
object
body
optional
Body
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/roles
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles"
method := "patch"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Removes roles from a catalog manifest version
/api/v1/catalog/{catalogId}/{version}/{architecture}/roles
Authorized
This endpoint removes roles from a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
request
object
body
optional
Body
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/roles
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/roles"
method := "delete"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes a catalog manifest and all its versions
/api/v1/catalog/{catalogId}
Authorized
This endpoint deletes a catalog manifest and all its versions
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
Request examples
/v1/catalog/{catalogId}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/catalog/{catalogId}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes a catalog manifest version
/api/v1/catalog/{catalogId}/{version}
Authorized
This endpoint deletes a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
Request examples
/v1/catalog/{catalogId}/{version}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/catalog/{catalogId}/{version}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Deletes a catalog manifest version architecture
/api/v1/catalog/{catalogId}/{version}/{architecture}
Authorized
This endpoint deletes a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
version
string
path
required
Version
architecture
string
path
required
Architecture
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}'
--header 'Authorization ••••••'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Delete , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}" );
request . Headers . Add ( "Authorization" , "••••••" );
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}"
method := "delete"
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Pushes a catalog manifest to the catalog inventory
/api/v1/catalog/push
Authorized
This endpoint pushes a catalog manifest to the catalog inventory
Parameters
Name
Type
In
Required
Description
pushRequest
object
body
optional
Push request
Request examples
/v1/catalog/push
Authorized
curl --location 'http://localhost/api/v1/catalog/push'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Post , "http://localhost/api/v1/catalog/push" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/push"
method := "post"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Push a catalog manifest to the catalog inventory asynchronously
/api/v1/catalog/push/async
Authorized
This endpoint pushes a catalog manifest to the catalog inventory in the background and returns a Job ID to track progress
Parameters
Name
Type
In
Required
Description
pushRequest
object
body
optional
Push request
Request examples
/v1/catalog/push/async
Authorized
curl --location 'http://localhost/api/v1/catalog/push/async'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Post , "http://localhost/api/v1/catalog/push/async" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/push/async"
method := "post"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Pull a remote catalog manifest
/api/v1/catalog/pull
Authorized
This endpoint pulls a remote catalog manifest
Parameters
Name
Type
In
Required
Description
pullRequest
object
body
optional
Pull request
Request examples
/v1/catalog/pull
Authorized
curl --location 'http://localhost/api/v1/catalog/pull'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Put , "http://localhost/api/v1/catalog/pull" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/pull"
method := "put"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Pull a remote catalog manifest asynchronously
/api/v1/catalog/pull/async
Authorized
This endpoint pulls a remote catalog manifest in the background and returns a Job ID to track progress
Parameters
Name
Type
In
Required
Description
pullRequest
object
body
optional
Pull request
Request examples
/v1/catalog/pull/async
Authorized
curl --location 'http://localhost/api/v1/catalog/pull/async'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Put , "http://localhost/api/v1/catalog/pull/async" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/pull/async"
method := "put"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Imports a remote catalog manifest metadata into the catalog inventory
/api/v1/catalog/import
Authorized
This endpoint imports a remote catalog manifest metadata into the catalog inventory
Parameters
Name
Type
In
Required
Description
importRequest
object
body
optional
Pull request
Request examples
/v1/catalog/import
Authorized
curl --location 'http://localhost/api/v1/catalog/import'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Put , "http://localhost/api/v1/catalog/import" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/import"
method := "put"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Imports a vm into the catalog inventory generating the metadata for it
/api/v1/catalog/import-vm
Authorized
This endpoint imports a virtual machine in pvm or macvm format into the catalog inventory generating the metadata for it
Parameters
Name
Type
In
Required
Description
importRequest
object
body
optional
Vm Impoty request
Request examples
/v1/catalog/import-vm
Authorized
curl --location 'http://localhost/api/v1/catalog/import-vm'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Put , "http://localhost/api/v1/catalog/import-vm" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/import-vm"
method := "put"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}
Updates a catalog
/api/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
This endpoint adds claims to a catalog manifest version
Parameters
Name
Type
In
Required
Description
catalogId
string
path
required
Catalog ID
request
object
body
optional
Body
Request examples
/v1/catalog/{catalogId}/{version}/{architecture}/claims
Authorized
curl --location 'http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims'
--header 'Authorization ••••••'
--header 'Content-Type: application/json'
--data '{ object }'
var client = new HttpClient ();
var request = new HttpRequestMessage ( HttpMethod . Patch , "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims" );
request . Headers . Add ( "Authorization" , "••••••" );
request . Headers . Add ( "Content-Type" , "application/json" );
request . Content = new StringContent ( "{ object }" );
request . Content = content ;
var response = await client . SendAsync ( request );
response . EnsureSuccessStatusCode ();
var responseString = await response . Content . ReadAsStringAsync ();
package main
import (
"fmt"
"net/http"
"strings"
"io"
)
func main () {
url := "http://localhost/api/v1/catalog/{catalogId}/{version}/{architecture}/claims"
method := "patch"
payload := strings . NewReader ( `{ object }` )
client := & http . Client {}
req , err := http . NewRequest ( method , url , payload )
if err != nil {
fmt . Println ( err )
return
}
req . Header . Add ( "Content-Type" , "application/json" )
req . Header . Add ( "Authorization" , "••••••" )
res , err := client . Do ( req )
if err != nil {
fmt . Println ( err )
return
}
defer res . Body . Close ()
body , err := io . ReadAll ( res . Body )
if err != nil {
fmt . Println ( err )
return
}
fmt . Println ( string ( body ))
}