Docs.

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/account", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/account",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/stores", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/stores",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/stores", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "url": "https://mossgatecoffee.example"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "url": "https://mossgatecoffee.example",
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/stores",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/concepts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "url": "https://mossgatecoffee.example"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "url": "https://mossgatecoffee.example",
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/concepts",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/concepts/cpt_1a2b3c4d5e6f", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/concepts/cpt_1a2b3c4d5e6f",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { writeFile } from "node:fs/promises";

const res = await fetch("https://app.greenset.ai/v1/concepts/cpt_1a2b3c4d5e6f/images/square", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
if (!res.ok) {
  const { error } = await res.json();
  throw new Error(`${res.status} ${error.code}: ${error.message}`);
}
await writeFile("greenset-square.png", Buffer.from(await res.arrayBuffer()));

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/concepts/cpt_1a2b3c4d5e6f/images/square",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res, open("greenset-square.png", "wb") as f:
        f.write(res.read())
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/drafts", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/drafts",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/drafts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "concept_id": "cpt_1a2b3c4d5e6f",
    "destination_url": "https://mossgatecoffee.example/products/house-blend",
    "daily_budget_usd": 25
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "concept_id": "cpt_1a2b3c4d5e6f",
    "destination_url": "https://mossgatecoffee.example/products/house-blend",
    "daily_budget_usd": 25,
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/drafts",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/drafts/drf_0a1b2c3d4e5f", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/drafts/drf_0a1b2c3d4e5f",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/drafts/drf_0a1b2c3d4e5f/activate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "confirm_budget_usd": 25
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "confirm_budget_usd": 25,
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/drafts/drf_0a1b2c3d4e5f/activate",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/campaigns", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/campaigns",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/events", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/events",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/stop-all", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "confirm": "STOP"
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "confirm": "STOP",
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/stop-all",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/guardrails", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/guardrails",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/guardrails", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "hard_daily_cap_usd": 250,
    "autonomy": {
      "budget": "Notify"
    }
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "hard_daily_cap_usd": 250,
    "autonomy": {
        "budget": "Notify",
    },
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/guardrails",
    method="PUT",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/webhooks", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/webhooks",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/webhooks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": randomUUID(),
  },
  body: JSON.stringify({
    "url": "https://hooks.example.com/greenset",
    "events": [
      "campaign.live",
      "payment.failed",
      "balance.low"
    ]
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

body = {
    "url": "https://hooks.example.com/greenset",
    "events": ["campaign.live", "payment.failed", "balance.low"],
}

req = urllib.request.Request(
    "https://app.greenset.ai/v1/webhooks",
    method="POST",
    data=json.dumps(body).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Content-Type": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Idempotency-Key": randomUUID(),
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V",
    method="DELETE",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs
import { randomUUID } from "node:crypto";

const res = await fetch("https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V/test", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
    "Idempotency-Key": randomUUID(),
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request, uuid
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V/test",
    method="POST",
    data=b"",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
        "Idempotency-Key": str(uuid.uuid4()),
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V/deliveries", {
  headers: {
    Authorization: `Bearer ${process.env.GREENSET_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/webhooks/we_Rk7Lq2Xm9Pz4Tn6V/deliveries",
    headers={
        "Authorization": "Bearer " + os.environ["GREENSET_KEY"],
    },
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)

// Node 18 or later. Save as greenset.mjs, then: node greenset.mjs

const res = await fetch("https://app.greenset.ai/v1/openapi.json", {
});
const data = await res.json();
if (!res.ok) throw new Error(`${res.status} ${data.error.code}: ${data.error.message}`);
console.log(data);

# Python 3, standard library only.
import json, os, urllib.request
from urllib.error import HTTPError

req = urllib.request.Request(
    "https://app.greenset.ai/v1/openapi.json",
)
try:
    with urllib.request.urlopen(req) as res:
        data = json.load(res)
except HTTPError as e:
    err = json.load(e)["error"]
    raise SystemExit(f"{e.code} {err['code']}: {err['message']}")
print(data)