API Documentation

Current Version: 2.0

This API allows you to create and manage your orders with Tucia in a simple, programmatic way using conventional HTTP requests. The endpoints are intuitive and powerful, allowing you to easily make calls to retrieve information or to execute actions.

With this API, you are able to add Tucia's human-powered photo editing functionality to any application. This is especially useful for resellers who have their own websites or apps, and outsource the real editing service to Tucia.


Post a message

HTTP Request:

POST /orders/:order_id/message

Post a message to an order. The message will be sent to the editor automatically.


Query Parameters:

Name Type Description



The message body; maximum 5000 characters


make my eyes bigger

Example successful response:

    "errors": [],
    "data": [
         "order_id": "UVWXYZ123",
         "project_name": "John's wedding",
         "customer_id": 1234,
         "price": 3,
         "status": "reviewing",
         "revision": 1,
         "ordered_at": "2017-12-02T16:00:00+04:00",
         "conversations": [
                "from": "client",
                "content": "make my eyes bigger",
                "revision": 1,
                "created_at": "2017-12-02T18:00:00+04:00"
                "from": "tucia",
                "content": "we have received your order",
                "revision": 0,
                "created_at": "2017-12-02T17:00:00+04:00"

Example error response:

    "errors": [
      "Please do not post duplicated message"


Next: Add reference images