Releases

List and inspect pipeline releases, start a release, or cancel an existing one.

/spaces/{spaceId}/pipelines/{pipelineName}/releases
  • GETList releases in the pipeline.

    Sample request

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

    Example response

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
      "data": [
        {
          "number": 42,
          "createdAt": "2026-01-15T12:00:00.000Z",
          "summary": {
            "changes": {
              "reportedCount": 1
            }
          }
        }
      ]
    }

    Common errors

    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space or pipeline was not found.
/spaces/{spaceId}/pipelines/{pipelineName}/releases/start
  • POSTStart a release, optionally reusing artifacts and changes from an earlier release.

    Sample request

    POST /spaces/space_123/pipelines/web/releases/start HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>
    Content-Type: application/json
    
    {
      "sourceRelease": 41,
      "externalId": "build-42"
    }

    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 release was not found.
/spaces/{spaceId}/pipelines/{pipelineName}/releases/{releaseNumber}
  • GETGet details for the specified release.

    Sample request

    GET /spaces/space_123/pipelines/web/releases/42 HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>

    Example response

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
      "data": {
        "number": 42,
        "createdAt": "2026-01-15T12:00:00.000Z",
        "externalId": "build-42",
        "changes": [
          {
            "id": "a1b2c3d",
            "subject": "Update the web app",
            "parents": [
              "f6e5d4c"
            ]
          }
        ],
        "artifacts": [
          {
            "name": "bundle",
            "size": 2048,
            "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
          }
        ]
      }
    }

    Common errors

    • 400 The release number is invalid.
    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space, pipeline, or release was not found.
/spaces/{spaceId}/pipelines/{pipelineName}/releases/{releaseNumber}/cancel
  • POSTCancel the specified release.

    Sample request

    POST /spaces/space_123/pipelines/web/releases/42/cancel 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 release was not found.
    • 409 The release is already in progress.