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.

Full catalog of actions provided by the Colossal app (built-in). Third-party apps add their own actions when installed. See Apps.

Cart

ActionDescription
get_cartRetrieve a cart by UID
add_to_cartAdd a product to a cart
update_cart_itemChange a line item’s quantity
remove_from_cartRemove a line item from a cart

Checkout

ActionDescription
get_checkout_sessionRetrieve a checkout session
get_checkout_by_orderRetrieve checkout session by order ID

Customer

ActionDescription
get_customerRetrieve a customer by ID
create_customerCreate a new customer record
update_customerUpdate customer details

Product

ActionDescription
get_productRetrieve a product by ID
publish_productPublish a draft product
archive_productArchive a product
unarchive_productRestore an archived product
update_product_priceUpdate a product’s price

Orders

ActionDescription
get_orderRetrieve an order by ID
get_customer_ordersGet orders for a specific customer
update_order_statusChange an order’s status
update_order_metadataUpdate metadata on an order
lookup_order_countCount orders matching criteria

Inventory

ActionDescription
check_inventoryCheck stock levels for a product variant

Invoice

ActionDescription
get_invoiceRetrieve an invoice
create_invoiceCreate a new invoice

Email

ActionDescription
send_emailSend an email to a recipient

Payment

ActionDescription
get_paymentRetrieve a payment record
get_invoice_paymentsGet all payments for an invoice

HTTP

ActionDescription
http_requestSend an HTTP request to any URL

Using actions in agents

All actions accept parameters. Use data access variables to pass dynamic data:
{
  "action": "colossal/send_email",
  "parameters": {
    "to": "{{payload.customer_email}}",
    "subject": "Order {{payload.order_uid}} shipped",
    "body": "Your order is on its way."
  }
}