Give Feedback

godo.HostedAgents.ListTemplateBuilds()

Generated on 5 Nov 2026 from godo version v1.236.0

Copy page as Markdown View page as Markdown

Usage

client.HostedAgents.ListTemplateBuilds(ctx context.Context, templateID string, opt *godo.HostedAgentTemplateBuildListOptions) (*godo.HostedAgentTemplateBuildsListResponse, *godo.Response, error)

Description

ListTemplateBuilds returns build history for a template.

Parameters

templateID string required
opt *godo.HostedAgentTemplateBuildListOptions

Fields of `godo.HostedAgentTemplateBuildListOptions`

HostedAgentTemplateBuildListOptions paginates ListTemplateBuilds.

PageToken string
PageSize int

Returns

*godo.HostedAgentTemplateBuildsListResponse
*godo.Response: The HTTP response, with pagination Links, Meta, and Rate limit information.
error: Non-nil when the request fails. API errors are returned as *godo.ErrorResponse.

Fields of `godo.HostedAgentTemplateBuildsListResponse`

HostedAgentTemplateBuildsListResponse is returned by GET …/builds.

Builds []godo.HostedAgentTemplateBuild: JSON key: builds
NextPageToken string: Omitted from JSON when empty. JSON key: next_page_token

Request Sample

Show Request Sample

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/digitalocean/godo"
)

func main() {
	client := godo.NewFromToken(os.Getenv("DIGITALOCEAN_TOKEN"))
	ctx := context.TODO()

	result, _, err := client.HostedAgents.ListTemplateBuilds(ctx, "<your-template-id>", &godo.HostedAgentTemplateBuildListOptions{
		PageToken: "<your-page-token>",
		PageSize: 1234567,
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", result)
}