Topology

Read or replace the groups, targets, and dependencies that determine how releases flow through a pipeline.

/spaces/{spaceId}/pipelines/{pipelineName}/topology
  • GETGet the pipeline’s groups, targets, and dependencies.

    Sample request

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

    Example response

    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
      "data": [
        {
          "kind": "target",
          "name": "deploy",
          "after": []
        }
      ]
    }

    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.
  • PUTReplace the pipeline’s topology.

    Sample request

    PUT /spaces/space_123/pipelines/web/topology HTTP/1.1
    Host: api.munchii.com
    Authorization: Bearer <access-token>
    Content-Type: application/json
    
    [
      {
        "kind": "target",
        "name": "deploy",
        "after": []
      }
    ]

    Example response

    HTTP/1.1 204 No Content

    Empty response body.

    Common errors

    • 400 The topology is invalid or refers to a node that does not exist.
    • 401 The credentials are missing, expired, or invalid.
    • 403 The caller lacks permission for this operation.
    • 404 The space or pipeline was not found.