---
title: "Given a resource fully-qualified name of a resource returns its current status."
method: GET
path: "/v2/organizations/{organization}/settings/{setting}/status"
tags: ["Status"]
---

# Given a resource fully-qualified name of a resource returns its current status.

`GET /v2/organizations/{organization}/settings/{setting}/status`

## Request

- Base URL: `https://docs.tetrate.io` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.tetrate.io/v2/organizations/{organization}/settings/{setting}/status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/docs/v2/organizations/:organization/settings/:setting/status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `organization` string, required
- `setting` string, required

## Response `200`

A successful response.

- V2ResourceStatus: The ResourceStatus object provides information about the status of the configuration related to an Application or an API object. Applications and APIs are translated into configuration objects (config groups, ingress gateways, etc). This status object reflects the status of the Application and APIs with regard to the generated configuration, and exposes any configuration mismatch. This status only reflects the status of the configuration objects in Service Bridge. It does not provide information about the status of the generated configuration in the final clusters.
  - `status` 'UNKNOWN' | 'MISSING' | 'DIRTY' | 'CONFIGURED': The computed configuration status for the Application or API. - UNKNOWN: Unknown indicates that the status has not been computed. - MISSING: The missing status indicates that the configuration resource for the Applications or APIs do not exist. - DIRTY: Dirty Applications and APIs are those that have the corresponding configuration objects (config groups, ingress gateways, etc), but those objects have been directly modified or they current configuration does not match the one specified in the corresponding Application/API. - CONFIGURED: Configured Applications and APIs are those that have the corresponding configuration resources (config groups, ingress gateways, etc) and their configurations match the ones defined in the Application/API objects.
  - `resources` ResourceStatusConfigResourceStatus[]: List of the individual configuration resource statuses.
    - `status` 'UNKNOWN' | 'MISSING' | 'DIRTY' | 'CONFIGURED': The computed configuration status for the Application or API. - UNKNOWN: Unknown indicates that the status has not been computed. - MISSING: The missing status indicates that the configuration resource for the Applications or APIs do not exist. - DIRTY: Dirty Applications and APIs are those that have the corresponding configuration objects (config groups, ingress gateways, etc), but those objects have been directly modified or they current configuration does not match the one specified in the corresponding Application/API. - CONFIGURED: Configured Applications and APIs are those that have the corresponding configuration resources (config groups, ingress gateways, etc) and their configurations match the ones defined in the Application/API objects.
    - `resource` V2ConfigResource: ConfigResource represents a configuration object (group, ingress gateway, etc) that is related to an Application or API.
      - `fqn` string: The FQN of the resource this status is computed for.
      - `expectedEtag` string: The expected etag field is used to check the if the configuration resource contents have changed. This might not be relevant for all configuration resources, so this field may not be set. If it is not set, the status will only report the presence or absence of the configuration resource, but not differences in its contents. When this field is present, the status will also reflect changes in the contents of the configuration resource, and report it as DIRTY if there are differences.
      - `exclusivelyOwned` boolean: The exclusively owned flag indicates if the referenced configuration resource is exclusively owned by the object. Configuration resources that are exclusively owned by an object will be deleted when the object is deleted.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api.md) - [All operations](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrate/apis/tetrate-service-bridge-api/revisions/2f19c3a1ae57?raw)