Release Groups

The /release_groups endpoint provides read-only access to release groups. A release group is a logical grouping of releases, similar to how a repository groups branches. Each pattern is associated with one release group.

See Also

• Authentication — Required for all API requests
• Release Group — Release group concepts
• Release Management — Administering releases
• Releases API — Individual releases within a group

GET /api/v1/release_groups — Find Release Groups

Retrieve a list of release groups.

Endpoint

GET https://app.metakraftwerk.com/api/v1/release_groups

Query Parameters

Parameter	Type	Required	Description
name	string	No	Filter by release group name.

Response Schema

Returns an array of release group objects:

Field	Type	Description
id	integer	Unique release group ID.
name	string	Release group name.
deleted	boolean	Whether the release group is marked as deleted.
default_closed	boolean	Whether new releases in this group are created as closed by default.

Examples

cURL

# List all release groups
curl -X GET "https://app.metakraftwerk.com/api/v1/release_groups" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

# Find by name
curl -X GET "https://app.metakraftwerk.com/api/v1/release_groups?name=DWH_GROUP" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

JavaScript (Fetch)

const response = await fetch(
  'https://app.metakraftwerk.com/api/v1/release_groups?name=DWH_GROUP',
  { headers: { 'Authorization': `Bearer ${accessToken}` } }
);

const releaseGroups = await response.json();

Response Example

[
  {
    "id": 1,
    "name": "DWH_GROUP",
    "deleted": false,
    "default_closed": true
  }
]

Error Responses

Status	Condition	Example Message
401	Missing or invalid token	Not authenticated

---

GET /api/v1/release_groups/:id — Get Release Group

Retrieve a single release group by its ID.

Endpoint

GET https://app.metakraftwerk.com/api/v1/release_groups/:id

Path Parameters

Parameter	Type	Required	Description
id	integer	Yes	The release group ID.

Examples

cURL

curl -X GET "https://app.metakraftwerk.com/api/v1/release_groups/1" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

JavaScript (Fetch)

const response = await fetch(
  'https://app.metakraftwerk.com/api/v1/release_groups/1',
  { headers: { 'Authorization': `Bearer ${accessToken}` } }
);

const releaseGroup = await response.json();

Error Responses

Status	Condition	Example Message
401	Missing or invalid token	Not authenticated
404	Release group not found	No record found for id 'X'

---

POST /api/v1/release_groups — Create

Not implemented

PUT /api/v1/release_groups — Update

Not implemented

PATCH /api/v1/release_groups/:id — Patch

Not implemented

DELETE /api/v1/release_groups/:id — Remove

Not implemented