Fix relate/unrelate to use JSON:API relationships endpoint

Use PATCH/DELETE to /api/{entity}/{id}/relationships/{relation}
with array body, matching the JSON:API spec and dashboard3 implementation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: artpar

client/relation.go

@@ -38,27 +38,32 @@ func (e *ExtendedClient) FindRelated(entityName, referenceId, relationColumn str
 	return result, nil
 }
 
-// AddRelation associates a target entity with a source via a relationship.
-// POST /api/{entity}/{referenceId}/{relationColumn}
+// AddRelation associates a target entity with a source via JSON:API relationships endpoint.
+// PATCH /api/{entity}/{referenceId}/relationships/{relationColumn}
 func (e *ExtendedClient) AddRelation(entityName, referenceId, relationColumn, targetType, targetRefId string) error {
 	body := map[string]interface{}{
-		"data": map[string]interface{}{
-			"type": targetType,
-			"id":   targetRefId,
+		"data": []map[string]interface{}{
+			{"type": targetType, "id": targetRefId},
 		},
 	}
 
-	resp, err := e.nextRequest().SetBody(body).Post(
-		e.Endpoint + "/api/" + entityName + "/" + referenceId + "/" + relationColumn,
+	resp, err := e.nextRequest().SetBody(body).Patch(
+		e.Endpoint + "/api/" + entityName + "/" + referenceId + "/relationships/" + relationColumn,
 	)
 	return e.checkResponse(resp, err)
 }
 
-// RemoveRelation removes a relationship association.
-// DELETE /api/{entity}/{referenceId}/{relationColumn}/{targetRefId}
-func (e *ExtendedClient) RemoveRelation(entityName, referenceId, relationColumn, targetRefId string) error {
-	resp, err := e.nextRequest().Delete(
-		e.Endpoint + "/api/" + entityName + "/" + referenceId + "/" + relationColumn + "/" + targetRefId,
+// RemoveRelation removes a relationship association via JSON:API relationships endpoint.
+// DELETE /api/{entity}/{referenceId}/relationships/{relationColumn}
+func (e *ExtendedClient) RemoveRelation(entityName, referenceId, relationColumn, targetType, targetRefId string) error {
+	body := map[string]interface{}{
+		"data": []map[string]interface{}{
+			{"type": targetType, "id": targetRefId},
+		},
+	}
+
+	resp, err := e.nextRequest().SetBody(body).Delete(
+		e.Endpoint + "/api/" + entityName + "/" + referenceId + "/relationships/" + relationColumn,
 	)
 	return e.checkResponse(resp, err)
 }

cmd/relate.go

@@ -48,7 +48,8 @@ func unrelateCommand(appCtx *AppContext) *cli.Command {
 				return fmt.Errorf("usage: unrelate <entity> <reference_id> <relation_column> <target_ref_id>")
 			}
 
-			err := appCtx.Client.RemoveRelation(entity, refId, relation, targetRefId)
+			targetType := strings.TrimSuffix(relation, "_id")
+			err := appCtx.Client.RemoveRelation(entity, refId, relation, targetType, targetRefId)
 			if err != nil {
 				return err
 			}