CraftCart.io
  1. AdminStore
  • CraftCart API (Code-Verified)
    • Health
      • API health endpoint
    • Auth
      • Signup user and create first store
      • Login operator account
      • Trigger password reset email
      • Reset password
      • Current authenticated user profile
    • Storefront
      • Get storefront store metadata
      • List products
      • Get product by slug
      • List approved product reviews
      • Create or update verified review
      • List collections
      • Get collection by slug
      • Subscribe newsletter
      • Create cart
      • Get cart
      • List shipping methods
      • Add cart item
      • Update cart item quantity
      • Remove cart item
      • Apply discount code
      • Select shipping method
      • Create checkout session
      • Confirm checkout session
    • Public
      • Get public order tracking payload
      • Unsubscribe with query token
      • Unsubscribe with JSON token
    • AdminStore
      • Get store dashboard payload
        GET
      • Update store settings
        PATCH
      • Get Stripe status
        GET
      • Create Stripe account onboarding link
        POST
      • Create Stripe dashboard link
        POST
      • Reset Stripe connection
        POST
      • Create domain onboarding link
        POST
      • Check domain DNS status
        POST
      • List storefront tokens
        GET
      • Create storefront token
        POST
      • Rotate storefront token
        POST
      • Revoke storefront token
        POST
      • List team members
        GET
      • Create team invite
        POST
      • Resend team invite
        POST
      • Revoke team access
        POST
      • Verify email provider settings
        GET
      • Send test email
        POST
      • Send test email for template key
        POST
      • List operational issues
        GET
      • Upload media
        POST
      • Preview CraftOS link state
        POST
      • Connect CraftOS
        POST
      • Disconnect CraftOS
        POST
      • Sync CraftOS backfill
        POST
    • AdminProducts
      • List products
      • Create product
      • Get product
      • Update product
      • Update product status
      • Adjust product variant inventory
    • AdminCollections
      • List collections
      • Create collection
      • Get collection
      • Update collection
    • AdminCustomers
      • List customers
      • Export customers CSV
      • Import customers CSV
      • Get customer
      • Update customer
    • AdminDiscounts
      • List discounts
      • Create discount
      • Update discount
    • AdminOrders
      • List orders
      • Get order
      • Create fulfilment
    • AdminReviews
      • List reviews for moderation
      • Update review moderation state
    • AdminMarketing
      • List marketing templates
      • Create marketing template
      • Update marketing template
      • Delete marketing template
      • List marketing lists
      • Create marketing list
      • Update marketing list
      • Delete marketing list
      • Preview marketing audience
      • Send generic campaign
      • Send newsletter campaign
      • Send old-customer campaign
      • Send product announcement campaign
      • Send collection announcement campaign
    • IntegrationsInternal
      • Internal CraftOS backfill trigger
      • Internal CraftOS disconnect trigger
    • WebhooksInternal
      • Stripe webhook receiver
      • Hosted domain sync webhook
    • Schemas
      • SuccessMeta
      • ErrorResponse
      • Address
      • Product
      • Collection
      • Cart
      • Review
      • StorefrontStoreEnvelope
      • ProductListEnvelope
      • ProductDetailEnvelope
      • ProductReviewsEnvelope
      • StorefrontReviewWriteEnvelope
      • CollectionListEnvelope
      • CollectionDetailEnvelope
      • NewsletterSubscribeEnvelope
      • CartEnvelope
      • ShippingMethodsEnvelope
      • CreateCheckoutSessionEnvelope
      • ConfirmCheckoutSessionEnvelope
      • PublicOrderTrackingEnvelope
      • PublicUnsubscribeEnvelope
      • CreateStorefrontReviewRequest
      • NewsletterSubscribeRequest
      • CreateCartRequest
      • AddCartItemRequest
      • UpdateCartItemRequest
      • ApplyDiscountRequest
      • SelectShippingMethodRequest
      • CreateCheckoutSessionRequest
      • ConfirmCheckoutSessionRequest
      • PublicUnsubscribeRequest
      • HealthEnvelope
      • GenericSuccessEnvelope
      • MessageEnvelope
      • SignupRequest
      • LoginRequest
      • ForgotPasswordRequest
      • ResetPasswordRequest
      • AuthMembership
      • AuthSignupEnvelope
      • AuthLoginEnvelope
      • AuthMeEnvelope
      • AdminUpdateStoreRequest
      • AdminUpsertProductRequest
      • AdminInventoryAdjustmentRequest
      • AdminUpsertCollectionRequest
      • AdminUpdateCustomerRequest
      • AdminUpsertDiscountRequest
      • CreateFulfilmentRequest
      • MarketingAudience
      • MarketingFilters
      • MarketingTemplateCreateRequest
      • MarketingTemplateUpdateRequest
      • MarketingListCreateRequest
      • MarketingListUpdateRequest
      • PreviewMarketingAudienceRequest
      • SendGenericMarketingCampaignRequest
      • SendNewsletterCampaignRequest
      • SendOldCustomersCampaignRequest
      • SendProductAnnouncementRequest
      • SendCollectionAnnouncementRequest
      • CraftOsLinkRequest
  1. AdminStore

Upload media

POST
https://api.craftcart.io/api/v1/admin/store/media/upload
Last modified:2026-04-18 03:08:00
Admin/operator endpoint. Requires Authorization: Bearer <jwt> and x-store-id tenant header.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
API Key
Add parameter in header
x-store-id
Example:
x-store-id: ********************
or
Body Params multipart/form-dataRequired

Responses

🟢201GenericSuccessResponse
application/json
Success payload wrapper
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.craftcart.io/api/v1/admin/store/media/upload' \
--header 'Authorization: Bearer <token>' \
--header 'x-store-id: <api-key>' \
--form 'purpose="general"' \
--form 'file=@""'
Response Response Example
{
    "success": true,
    "data": {
        "property1": "string",
        "property2": "string"
    },
    "meta": {
        "property1": "string",
        "property2": "string"
    }
}
Modified at 2026-04-18 03:08:00
Previous
List operational issues
Next
Preview CraftOS link state
Built with