Groups

Manage the groups that organize targets and apply scheduling rules within a pipeline.

/spaces/{spaceId}/pipelines/{pipelineName}/groups/{groupName}
  • PUTAdd a named group to the pipeline.

    Sample request

    PUT /spaces/space_123/pipelines/web/groups/staging HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>
    Content-Type: application/json
    
    {}

    Example response

    HTTP/1.1 204 No Content

    Empty response body.

    Common errors

    • 400 Use application/json and send valid JSON that matches the expected schema.
    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space or pipeline was not found.
  • PATCHUpdate selected settings for the group.

    Sample request

    PATCH /spaces/space_123/pipelines/web/groups/staging HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>
    Content-Type: application/json
    
    {
      "name": "production"
    }

    Example response

    HTTP/1.1 204 No Content

    Empty response body.

    Common errors

    • 400 Use application/json and send valid JSON that matches the expected schema.
    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space, pipeline, or group was not found.
  • DELETERemove the group from the pipeline.

    Sample request

    DELETE /spaces/space_123/pipelines/web/groups/staging HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>

    Example response

    HTTP/1.1 204 No Content

    Empty response body.

    Common errors

    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space, pipeline, or group was not found.
    • 409 The group contains nodes or has dependents.