Give Feedback

godo.HostedAgentTriggers.Get()

Generated on 5 Nov 2026 from godo version v1.236.0

Copy page as Markdown View page as Markdown

Usage

client.HostedAgentTriggers.Get(ctx context.Context, triggerID string) (*godo.HostedAgentTrigger, *godo.Response, error)

Description

Get returns a single trigger by ID.

Parameters

triggerID string required

Returns

*godo.HostedAgentTrigger
*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.HostedAgentTrigger`

HostedAgentTrigger is a webhook or cron automation bound to an agent/session.

TriggerID string: Omitted from JSON when empty. JSON key: trigger_id
TeamID int64: Omitted from JSON when empty. JSON key: team_id
Kind godo.HostedAgentTriggerKind: Omitted from JSON when empty. JSON key: kind
Name string: Omitted from JSON when empty. JSON key: name
Status godo.HostedAgentTriggerStatus: Omitted from JSON when empty. JSON key: status
SessionMode godo.HostedAgentTriggerSessionMode: Omitted from JSON when empty. JSON key: session_mode
AgentKind godo.HostedAgentKind: Omitted from JSON when empty. JSON key: agent_kind
PromptTemplate string: Omitted from JSON when empty. JSON key: prompt_template
Output *godo.HostedAgentTriggerOutputRead: Omitted from JSON when empty. JSON key: output
SessionTemplate string: Omitted from JSON when empty. JSON key: session_template
BoundSessionID string: Omitted from JSON when empty. JSON key: bound_session_id
Webhook *godo.HostedAgentWebhookConfig: Omitted from JSON when empty. JSON key: webhook
Cron *godo.HostedAgentCronConfig: Omitted from JSON when empty. JSON key: cron
CreatedAt godo.Timestamp: Omitted from JSON when empty. JSON key: created_at
UpdatedAt godo.Timestamp: Omitted from JSON when empty. JSON key: updated_at

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.HostedAgentTriggers.Get(ctx, "<your-trigger-id>")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", result)
}