List the systems a component is in

GET

/components/{name}/memberships

const url = 'https://example.com/api/v1/components/example/memberships';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/components/example/memberships

The systems this component is bound into, ordered by name. A component may belong to several: a rack DSP serving three rooms is a member of all three, and each of them depends on it. Exactly one membership may be marked primary, the default for a question asked without a system in hand. Gated by component:read; an out-of-scope component is a non-disclosing 404.

Parameters

Path Parameters

name

required

Technical name of the component

string

Technical name of the component

Responses

200

application/json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

component

required

string

memberships

required

Array<object> | null

object

component

required

Technical name of the component

string

primary

required

Whether this membership is the component’s default when no system is given

boolean

system

required

Technical name of the system

string

system_count

required

How many systems this component belongs to in total; more than one means it is shared

integer format: int64

Example

{
  "$schema": "/api/v1/schemas/ListComponentMembershipsOutputBody.json"
}

default

Error

application/problem+json

object

$schema

A URL to the JSON Schema for this object.

string format: uri

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

Example

{
  "$schema": "/api/v1/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}