Forward API reference.
Description
Updates an Environment's configuration and display information with POST.
Path
POST /api/v1/forward/environments/{id}
Request headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Content-Type | Yes | application/json |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Environment ID. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | New name. |
description | string | No | New description. |
config | Environment config | No | New configuration. It must not be null; an explicit null returns 400. See schemas for field details. |
metadata | object | No | Environment metadata to merge. It must not be null; an explicit null returns 400. |
Example request
Example response
HTTP 200 OK
Response fields
The response is an Environment object.
Errors
| HTTP | Type | Trigger |
|---|---|---|
| 400 | invalid_request_error | The request body, path parameters, or query parameters are invalid. |
| 400 | invalid_request_error | If the reserved key created_by is supplied, message is metadata key "created_by" is reserved, identifying the invalid field. |
| 401 | authentication_error | The authentication token is missing or invalid. |
| 403 | permission_error | The caller cannot access this resource. |
| 404 | not_found_error | The resource does not exist or is not visible. |
| 500/502/503 | api_error | Forward or a dependent service failed. |