# Kargo

> Kargo (Kargo Technologies, kargo.ai) builds an AI-powered smart loading dock. Camera
> towers and forklift-mounted cameras apply computer vision to every pallet moving
> through a dock door, reading LPN, SKU, lot code and expiration-date labels to automate
> shipping and receiving, verify loads, detect damage, and feed inventory visibility,
> FSMA traceability, claims management and automated ASNs back into the customer WMS.
> Kargo publishes a public integration surface for that data exchange.

Generated by API Evangelist from Kargo's public documentation on 2026-08-23. Kargo does
not publish an llms.txt of its own; this file is not served by Kargo.

## Getting started

- [Integration documentation](https://docs.kargo.ai/): the five integration methods and
  when to use each.
- [Authentication](https://docs.kargo.ai/authentication): OAuth 2.0 client-credentials
  against `https://mykargo.us.auth0.com/oauth/token` with audience
  `https://api.kargo.zone/public_graphql`. Kargo creates and provides the client_id and
  client_secret; there is no self-service signup. Tokens last 24 hours — cache them.
- [Basic LPN validation walkthrough](https://docs.kargo.ai/basic_examples): end-to-end
  create-shipment then receive-webhooks example.

## APIs

- [Kargo Document Intake API (REST)](https://docs.kargo.ai/rest-api): base
  `https://api.kargo.zone/v1`. Three operations — `POST /documents` (upsert a shipment,
  its orders and its order items), `POST /sku_master`, `GET /sku_master`. JSON or XML
  request bodies. RFC 9457 `application/problem+json` errors.
- [Kargo Public GraphQL API](https://docs.kargo.ai/graphql/): endpoint
  `https://api.kargo.zone/public_graphql`. 5 queries, 11 mutations, 1 subscription, 84
  types. Kargo labels it "legacy, maintained for existing integrations", but it is the
  larger surface — it holds every read, the event stream, the SKU delete, and image
  parsing. Anonymous introspection is open.
- [Unified Endpoint API](https://docs.kargo.ai/unified-endpoint): send arbitrary JSON to
  the `processPayload` GraphQL mutation and Kargo infers the operation. Returns
  `{ success, message, loggingId }`.
- [Webhook (Push) API](https://docs.kargo.ai/webhooks/shipment): Kargo POSTs to a
  customer-hosted endpoint with HTTP Basic auth, at
  [shipment completion](https://docs.kargo.ai/webhooks/shipment) and
  [per pallet](https://docs.kargo.ai/webhooks/pallet).
- [Flat file / AS2](https://docs.kargo.ai/flat_file): shipment files over email, SFTP or
  AS2 (RFC 4130), with a published trading-partner profile and certificate fingerprint.

## Specifications

- [OpenAPI 3.1 (Kargo-published)](https://api.kargo.zone/v1/docs/openapi.yaml)
- [Swagger UI reference](https://api.kargo.zone/v1/docs/)
- [Postman collection (Kargo-published)](https://docs.kargo.ai/kargo-public-graphql.postman_collection.json)
- [GraphQL SDL (captured by introspection)](https://raw.githubusercontent.com/api-evangelist/kargo/refs/heads/main/graphql/kargo-public-graphql.graphql)

## Things an agent should know before writing

- `POST /documents` defaults to `orderItemUpdateStrategy: OVERWRITE` when items are
  present and no strategy is given. That REMOVES every existing order item not in the
  request. Always send the complete item list, or set the strategy explicitly.
- Strategies: `OVERWRITE` (replace all), `MERGE` (update matched lpn+sku), `APPEND` (add;
  a duplicate lpn+sku returns 409), `DELETE` (remove matched lpn+sku).
- Idempotency is upsert-by-natural-key, not an Idempotency-Key header. Shipment and order
  are idempotent; order items are not under OVERWRITE (rows are recreated with new ids).
- There is no shipment or order delete on either surface. Only order items and SKUs can
  be removed.
- No rate limits, no status page, no deprecation policy, and no changelog are published.
- Send `Correlation-Id` on `POST /documents` for traceability; Kargo echoes it back.

## Company

- [Website](https://www.kargo.ai/)
- [How it works](https://www.kargo.ai/how-it-works)
- [Blog](https://www.kargo.ai/blog)
- [Customer dashboard](https://athena.mykargo.com/)
- [GitHub](https://github.com/mykargo)
- [Terms of service](https://www.kargo.ai/terms-of-service)
- [Privacy policy](https://www.kargo.ai/privacy-policy)