fix: run actions don't accept json-api resource request bodies

[brandonc]

Description

According to the docs and in practice, the run actions group of endpoints commonly accept a request body with a single "comment" attribute. This isn't a json-api resource document, and it shouldn't be encoded into a "data" → "attributes" nesting.

As far as I know, these are the only request bodies that aren't compliant, and it's not worthwhile to convert these endpoints from actions to resources.

Testing plan

I added an integration test for this in particular, but I also I wrote a simple program to POST a run apply to a service like requestb.in so you can see the request body:

package main

import (
	"context"

	"github.com/hashicorp/go-tfe"
)

func main() {
	client, err := tfe.NewClient(&tfe.Config{
		Address: "https://env12e9eawjlf.x.pipedream.net",
		Token:   "xxx.atlasv1.xxx",
	})

	if err != nil {
		panic(err)
	}

	err = client.Runs.Apply(context.Background(), "run-NjC97hxkfWZ4eHTA", tfe.RunApplyOptions{
		Comment: tfe.String("hello, world"),
	})

	if err != nil {
		panic(err)
	}
}

External links

• API documentation

[Uk1288]

LGTM 🎉 , tested the run actions (Discard, apply, cancel) locally.

[sebasslash]

The docs are subtle, excellent catch!

[github-actions]

Reminder to the contributor that merged this PR: if your changes have added important functionality or fixed a relevant bug, open a follow-up PR to update CHANGELOG.md with a note on your changes.