Add ListHandOffTargets

handoff_target.go

@@ -0,0 +1,10 @@
+package client
+
+type HandOffTarget struct {
+	// ID is your identifier of choice for this hand-off target. Can be anything consisting
+	// of letters, numbers, or any of the following characters: `_` `-` `+` `=`.
+	ID string `json:"id"`
+
+	// Name is the hand-off target’s name.
+	Name string `json:"name"`
+}

hand_off_target_upsert.go → handoff_target_upsert.go

@@ -14,7 +14,9 @@ type UpsertHandOffTargetParams struct {
 	Name string `json:"name"`
 }
 
-// UpsertHandOffTarget inserts or updates a hand-off target
+// UpsertHandOffTarget inserts or updates a hand-off target.
+//
+// Note: requires a `Management` API key.
 func (c *Client) UpsertHandOffTarget(ctx context.Context, p *UpsertHandOffTargetParams) error {
 	rsp, err := c.makeRequest(ctx, http.MethodPost, "hand-off-targets", p)
 	if err != nil {

handoff_targets.go

@@ -0,0 +1,32 @@
+package client
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+)
+
+type HandOffTargets struct {
+	Targets []*HandOffTarget `json:"targets"`
+}
+
+// ListHandOffTargets returns all of your hand off targets.
+//
+// Note: requires a `Management` API key.
+func (c *Client) ListHandOffTargets(ctx context.Context) (*HandOffTargets, error) {
+	rsp, err := c.makeRequest(ctx, http.MethodGet, "hand-off-targets", nil)
+	if err != nil {
+		return nil, err
+	}
+	defer rsp.Body.Close()
+
+	if err := responseError(rsp); err != nil {
+		return nil, err
+	}
+
+	var targets HandOffTargets
+	if err := json.NewDecoder(rsp.Body).Decode(&targets); err != nil {
+		return nil, err
+	}
+	return &targets, nil
+}