Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.colossal.sh/llms.txt

Use this file to discover all available pages before exploring further.

Built-in operations an agent can run as App Action steps. Each action has typed inputs and outputs.

Cart

add_to_cart

Add a product to the cart. Input
cart_uid
string
required
Cart UUID
product_uid
string
required
Product UUID to add
quantity
integer
Quantity to add min: 1. Default: 1.
Output
cart_uid
string | null
line_item_id
integer | null
product_uid
string | null
quantity
integer | null

get_cart

Retrieve cart details by UUID. Input
cart_uid
string
required
Cart UUID
Output
cart_uid
string | null
line_items
CartLineItemOutput[]
item_count
integer
subtotal
number

remove_from_cart

Remove an item from the cart. Input
cart_uid
string
required
Cart UUID
line_item_id
integer
required
Line item ID to remove min: > 0.
Output
cart_uid
string | null
line_item_id
integer | null
product_uid
string | null

update_cart_item

Update the quantity of a cart item. Input
cart_uid
string
required
Cart UUID
line_item_id
integer
required
Line item ID to update min: > 0.
quantity
integer
required
New quantity min: 1.
Output
cart_uid
string | null
line_item_id
integer | null
previous_quantity
integer | null
new_quantity
integer | null

Checkout

get_checkout_by_order

Retrieve checkout session for a given order. Input
order_id
integer
required
Order ID min: > 0.
Output
checkout
CheckoutOutput | null

get_checkout_session

Retrieve checkout session details by UUID. Input
checkout_uid
string
required
Checkout session UUID
Output
checkout
CheckoutOutput | null

Customers

create_customer

Create a new customer. Input
email
string
required
Customer email address
full_name
string
required
Customer full name
Output
customer
CustomerOutput | null

get_customer

Retrieve customer by ID, UUID, or email. Input
customer_id
integer | null
Customer ID
customer_uid
string | null
Customer UUID
email
string | null
Customer email
Output
customer
CustomerOutput | null

update_customer

Update customer details. Input
customer_id
integer
required
Customer ID to update
email
string | null
New email address
full_name
string | null
New full name
Output
customer
CustomerOutput | null
changed_fields
string[]

Email

send_email

Sends an email to a recipient. Input
to
string
required
subject
string
required
minLen: 1, maxLen: 998.
html
string
Default: "".
content
string
Default: "".
from
string | null
Output
to
string
subject
string

HTTP

http_request

Sends an HTTP request to any URL. Input
url
string
required
minLen: 1, maxLen: 2083.
method
enum (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`)
required
headers
object
body
object
timeout
integer
min: 1, max: 300. Default: 30.
Output
status_code
integer
min: 0.
response
object | string | null
headers
object

Inventory

check_inventory

Check current inventory level for a product and determine if stock is low. Input
product_id
integer
required
min: > 0.
threshold
integer
min: 0. Default: 10.
Output
product_id
integer | null
product_name
string | null
inventory_count
integer | null
is_low_stock
boolean | null
threshold
integer | null

Invoices

create_invoice

Create a new invoice with line items. Input
customer_id
integer | null
currency
string | null
bill_to_name
string | null
bill_to_email
string | null
line_items
CreateInvoiceLineItemInput[]
required
Output
invoice_id
integer | null
invoice_uid
string | null
status
string | null
total
integer | null

create_invoice_line_item

Append a line item to an existing invoice. Input
invoice_uid
string
required
title
string
required
quantity
integer
required
min: 1.
unit_price
integer
required
min: 0.
product_id
integer | null
description
string | null
Output
line_item_id
integer | null
invoice_id
integer | null

get_invoice

Retrieve invoice details by UID. Input
invoice_uid
string
required
Output
invoice_id
integer | null
invoice_uid
string | null
invoice_number
string | null
status
string | null
source
string | null
customer_id
integer | null
order_id
integer | null
currency
string | null
subtotal
integer | null
discount
integer | null
tax
integer | null
total
integer | null
bill_to_name
string | null
bill_to_email
string | null
line_items
InvoiceLineItemOutput[]

Orders

get_order

Retrieve order details by ID. Input
order_id
integer
required
min: > 0.
Output
order_id
integer | null
order_uid
string | null
status
string | null
customer_id
integer | null
customer_email
string | null
subtotal_amount
number | null
total_amount
number | null
tax
number | null
line_items
OrderLineItemOutput[]

get_order_history

Retrieve orders for a specific customer. Input
customer_id
integer
required
min: > 0.
limit
integer
min: 1, max: 100. Default: 50.
Output
customer_id
integer | null
orders
CustomerOrderOutput[]
count
integer

lookup_order_count

Get the total number of orders placed by a specific customer. Input
customer_id
integer
required
min: > 0.
Output
customer_id
integer | null
order_count
integer | null

update_billing_address

Update an order’s billing address. Input
order_uid
string
required
line1
string
required
city
string
required
postal_code
string
required
country
string
required
line2
string | null
state
string | null
Output
order_id
integer | null

update_order

Update order fields in a secure workspace-scoped manner. Input
order_id
integer
required
min: > 0.
updates
object
required
Fields to update on the order
Output
message
string | null

update_order_metadata

Update order integration metadata. Input
order_id
integer
required
min: > 0.
metadata
object
required
Metadata fields to merge into the order
Output
order_id
integer | null

update_order_status

Update the status of an order. Input
order_id
integer
required
min: > 0.
status
enum (`pending`, `confirmed`, `complete`)
required
New order status
Output
order_id
integer | null
previous_status
string | null
new_status
string | null

update_shipping_address

Update an order’s shipping address. Input
order_uid
string
required
line1
string
required
city
string
required
postal_code
string
required
country
string
required
line2
string | null
state
string | null
Output
order_id
integer | null

Payments

get_invoice_payments

Retrieve all payments for an invoice. Input
invoice_id
integer
required
min: > 0.
limit
integer
min: 1, max: 50. Default: 10.
Output
invoice_id
integer | null
payments
PaymentSummary[]
total_count
integer

get_payment

Retrieve payment details by UID. Input
payment_uid
string
required
Output
payment_id
integer | null
payment_uid
string | null
invoice_id
integer | null
status
string | null
amount
integer | null
currency
string | null
payment_provider
string | null
payment_method
string | null
card_brand
string | null
card_last4
string | null
transaction_id
string | null
failure_code
string | null
failure_message
string | null

Products

archive_deliverable

Archive a product deliverable. Input
deliverable_uid
string
required
Output
deliverable_uid
string | null

archive_product

Archive a product to hide it from the store. Input
product_uid
string
required
Output
product_uid
string | null

create_deliverable

Create a new product deliverable in the workspace. Input
type
string
required
name
string
required
config
object | null
Output
deliverable_uid
string | null
name
string | null

create_price

Create a new price for a product variant. Input
variant_uid
string
required
name
string | null
amount
number
required
min: > 0.
currency
string
Default: "USD".
recurring_interval
string | null
is_default
boolean
Default: false.
Output
price_uid
string | null
is_default
boolean | null

create_product

Create a new product in the store with optional price and images. Input
name
string
required
handle
string
required
description
string | null
tagline
string | null
price
number | null
currency
string | null
image_urls
string[]
Output
product_uid
string | null
name
string | null
handle
string | null

get_product

Retrieve product details by UID. Input
product_uid
string
required
Output
product_id
integer | null
product_uid
string | null
name
string | null
handle
string | null
description
string | null
is_published
boolean | null
is_archived
boolean | null
default_variant
ProductVariantOutput | null

publish_product

Publish a product to make it visible in the store. Input
product_uid
string
required
Output
product_uid
string | null
name
string | null

set_default_price

Mark a price as the default for its variant. Input
price_uid
string
required
Output
price_uid
string | null

unarchive_product

Restore an archived product. Input
product_uid
string
required
Output
product_uid
string | null

update_deliverable

Update a product deliverable’s name, type, or config. Input
deliverable_uid
string
required
name
string | null
type
string | null
config
object | null
Output
deliverable_uid
string | null

update_product

Update an existing product’s details. Input
product_uid
string
required
name
string | null
handle
string | null
description
string | null
tagline
string | null
Output
product_uid
string | null
name
string | null

update_product_price

Update the default price of a product. Input
product_uid
string
required
price
number
required
min: > 0.
currency
string | null
Output
product_uid
string | null
price_uid
string | null
new_price
number | null
currency
string | null