[Workers] Add getting started guide for API and IaC

Author: markjmiller

src/content/docs/workers/configuration/multipart-upload-metadata.mdx

@@ -24,6 +24,12 @@ If you're using the [Workers Script Upload API](/api/resources/workers/subresour
 }
 ```
 
+:::note
+
+See the [Workers API and IaC](/workers/get-started/api-iac) getting started guide for examples of this in use.
+:::
+
+
 ## Attributes
 
 The following attributes are configurable at the top-level.

src/content/docs/workers/get-started/api-iac.mdx

@@ -0,0 +1,89 @@
+---
+title: API and IaC
+pcx_content_type: concept
+sidebar:
+  order: 5
+---
+
+import { GitHubCode } from "~/components";
+
+Uploading and managing a Worker is easy with [Wrangler](/workers/wrangler/configuration), but sometimes you need to do it more programmatically. You might do this with IaC ("Infrastructure as Code") tools or by calling the [Cloudflare API](https://developers.cloudflare.com/api) directly. Use cases for the API might include build and deploy scripts, CI/CD pipelines, custom dev tools, or testing. We provide API SDK libraries for common languages that make interacting with the API easier, such as [cloudflare-typescript](https://github.com/cloudflare/cloudflare-typescript). For IaC, a common tool is HashiCorp's Terraform. We have a [Cloudflare Terraform Provider](/terraform) with Workers resources.
+
+## Examples
+
+Here are examples of uploading a Worker script with common tools and languages. In particular, this highlights how to upload script content and format [multipart upload metadata](/workers/configuration/multipart-upload-metadata) which is different for each approach.
+
+### cURL
+
+- [Upload Worker Module API docs](https://developers.cloudflare.com/api/resources/workers/subresources/scripts/methods/update/)
+- Replace `<account_id>` with your [account id](/fundamentals/setup/find-account-and-zone-ids) and `<api_token>` with an [API token](/fundamentals/api/get-started/create-token) (not Global API key)
+
+```bash
+curl https://api.cloudflare.com/client/v4/accounts/<account_id>/workers/scripts/my-hello-world-script \
+  -X PUT \
+  -H 'Authorization: Bearer <api_token>' \
+  -F 'metadata={
+        "main_module":"my-hello-world-script.mjs",
+        "bindings": [
+          {
+            "type": "plain_text",
+            "name": "MESSAGE",
+            "text": "Hello World!"
+          }
+        ],
+        "compatibility_date": "2025-03-11"
+      };type=application/json' \
+  -F 'my-hello-world-script.mjs=@-;filename=my-hello-world-script.mjs;type=application/javascript+module' <<EOF
+export default {
+  async fetch(request, env, ctx) {
+    return new Response(env.MESSAGE, { status: 200 });
+  }
+};
+EOF
+```
+
+:::note
+Change `my-hello-world-script.mjs=@-;` to `my-hello-world-script.mjs=@./my-hello-world-script.mjs;` and remove everything after and including `<<EOF` to upload a local file named `my-hello-world-script.mjs` instead (where the contents of that file can be the same script content above).
+:::
+
+### cloudflare-typescript
+
+- [cloudflare-typescript github](https://github.com/cloudflare/cloudflare-typescript)
+- Note this example uses a [Global API Key](/fundamentals/api/get-started/keys) instead of an API token
+
+```mdx
+<GitHubCode
+	repo="cloudflare/cloudflare-typescript"
+	file="examples/workers/script-upload.ts"
+	commit="91d4cec33d0cfbc24747b500f67747bf7c6b5462"
+	lang="ts"
+	code={{
+		collapse: "1-2",
+	}}
+/>
+```
+
+### Terraform
+
+- [Cloudflare Terraform docs](/terraform)
+- [cloudflare_workers_script (Resource) docs](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/workers_script)
+
+In this example, you need a local file named `my-hello-world-script.mjs` with script content similar to the above examples.
+
+```tf
+resource "cloudflare_workers_script" "my-hello-world-script" {
+  account_id = "<replace_me>"
+  script_name = "my-hello-world-script"
+  main_module = "my-hello-world-script.mjs"
+  content = file("my-hello-world-script.mjs")
+  bindings = [{
+    name = "MESSAGE"
+    type = "plain_text"
+    test = "Hello World!"
+  }]
+}
+```
+
+:::note
+The Workers Script resource does not have a metadata property. All its child properties are at the top-level of the resource class.
+:::