# Updates an existing flag

**PUT /references/flags/{FlagID}**




## Servers
- Raidiam Directory Sandbox Environment: https://matls-api.sandbox.raidiam.io (Raidiam Directory Sandbox Environment)


## Authentication methods
- O auth


## Parameters
### Headers
- **x-fapi-auth-date** (string)
  The time when the PSU last logged in with the TPP. 
  All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: 
  Sun, 10 Sep 2017 19:43:31 UTC
- **x-fapi-customer-ip-address** (string)
  The PSU's IP address if the PSU is currently logged in with the TPP.
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.
- **x-customer-user-agent** (string)
  Indicates the user-agent that the PSU is using.

### Path parameters
- **FlagID** (string)
  The ID of the flag to target


### Body: application/json (object)

- **Cascade** (boolean)
  If set to true on an operation that would deactivate the resource, all references to this given resource in other resources will be removed
- **AccessLevel** (integer)
  The access level of a flag as a number. The higher the number, the more sensitive it is
- **Description** (string)
  The description of this flag
- **Name** (string)
  The name of this flag
- **Status** (string)
  Current status of this resource
- **Type** (string)
  The type of this tag
- **Value** (string)
  The value of this flag


## Responses
### 200
Response with for a single flag
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **CreatedAt** (string(date-time))

- **Id** (string)
  Unique ID of the flag
- **UpdatedAt** (string(date-time))

- **AccessLevel** (integer)
  The access level of a flag as a number. The higher the number, the more sensitive it is
- **Description** (string)
  The description of this flag
- **Name** (string)
  The name of this flag
- **Status** (string)
  Current status of this resource
- **Type** (string)
  The type of this tag
- **Value** (string)
  The value of this flag

### 400
Bad Request
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **errors** (array[string])
  Validation Error messages

### 401
Unauthorized
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 403
Forbidden
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 409
Conflict
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 429
Too many requests, maximum capacity reached. Requests are now throttled.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 500
Internal Server Error
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 502
Bad Gateway
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 504
Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.


[Powered by Bump.sh](https://bump.sh)