How to edit PSD text by API

Yes, an API can edit the type inside a Photoshop file. SudoMock reads the live text layers on upload and renders new wording, font, size and colour at request time, without opening Photoshop and without flattening the design around the text. Two calls do it. The first is setup and runs once per template; the second is the one your product calls.

1. Upload the PSD and find the text layers

const response = await fetch("https://api.sudomock.com/api/v1/psd/upload", {
  method: "POST",
  headers: {
    "x-api-key": "sm_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "psd_file_url": "https://your-storage.com/greeting-card.psd",
    "psd_name": "Greeting card"
  }),
});

const data = await response.json();
console.log(data);

<?php

$payload = <<<'JSON'
{
  "psd_file_url": "https://your-storage.com/greeting-card.psd",
  "psd_name": "Greeting card"
}
JSON;

$ch = curl_init("https://api.sudomock.com/api/v1/psd/upload");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

payload = {
    "psd_file_url": "https://your-storage.com/greeting-card.psd",
    "psd_name": "Greeting card"
}

response = requests.post(
    "https://api.sudomock.com/api/v1/psd/upload",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/psd/upload")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "psd_file_url": "https://your-storage.com/greeting-card.psd",
    "psd_name": "Greeting card"
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "psd_file_url": "https://your-storage.com/greeting-card.psd",
  "psd_name": "Greeting card"
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/psd/upload", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "psd_file_url": "https://your-storage.com/greeting-card.psd",
  "psd_name": "Greeting card"
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/psd/upload"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "psd_file_url": "https://your-storage.com/greeting-card.psd",
  "psd_name": "Greeting card"
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/psd/upload");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X POST "https://api.sudomock.com/api/v1/psd/upload" \
  -H "x-api-key: sm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "psd_file_url": "https://your-storage.com/greeting-card.psd",
    "psd_name": "Greeting card"
  }'

The response lists every text layer it found, each with a uuid and its current values.

{
  "data": {
    "uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "text_layers": [
      {
        "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
        "name": "Headline",
        "text_content": "YOUR BRAND",
        "font_postscript_name": "Poppins-Bold",
        "font_size": 96,
        "color": "#1A1A1A",
        "font_available": true,
        "is_editable": true,
        "segment_count": 1
      }
    ]
  }
}

Keep the mockup uuid and the layer uuid. Those two values are the whole interface from here on.

2. Render with your own wording

const response = await fetch("https://api.sudomock.com/api/v1/renders", {
  method: "POST",
  headers: {
    "x-api-key": "sm_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "text_layers": [
      {
        "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
        "text": "Happy birthday, Jane"
      }
    ]
  }),
});

const data = await response.json();
console.log(data);

<?php

$payload = <<<'JSON'
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Happy birthday, Jane"
    }
  ]
}
JSON;

$ch = curl_init("https://api.sudomock.com/api/v1/renders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: sm_your_api_key",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

payload = {
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "text_layers": [
        {
            "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
            "text": "Happy birthday, Jane"
        }
    ]
}

response = requests.post(
    "https://api.sudomock.com/api/v1/renders",
    headers={"x-api-key": "sm_your_api_key"},
    json=payload,
)

response.raise_for_status()
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.sudomock.com/api/v1/renders")
request = Net::HTTP::Post.new(uri)
request["x-api-key"] = "sm_your_api_key"
request["Content-Type"] = "application/json"

request.body = <<~JSON
  {
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "text_layers": [
      {
        "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
        "text": "Happy birthday, Jane"
      }
    ]
  }
JSON

response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts response.body

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Happy birthday, Jane"
    }
  ]
}`)

	req, err := http.NewRequest("POST", "https://api.sudomock.com/api/v1/renders", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("x-api-key", "sm_your_api_key")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String payload = """
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Happy birthday, Jane"
    }
  ]
}
""";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.sudomock.com/api/v1/renders"))
    .header("x-api-key", "sm_your_api_key")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using System.Net.Http;
using System.Text;

var payload = """
{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Happy birthday, Jane"
    }
  ]
}
""";

var request = new HttpRequestMessage(HttpMethod.Post, "https://api.sudomock.com/api/v1/renders");
request.Headers.Add("x-api-key", "sm_your_api_key");
request.Content = new StringContent(payload, Encoding.UTF8, "application/json");

var client = new HttpClient();
var response = await client.SendAsync(request);

Console.WriteLine(await response.Content.ReadAsStringAsync());

curl -X POST "https://api.sudomock.com/api/v1/renders" \
  -H "x-api-key: sm_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
    "text_layers": [
      {
        "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
        "text": "Happy birthday, Jane"
      }
    ]
  }'

The finished image is at data.print_files[0].export_path. Everything you did not name keeps its authored appearance, so the rest of the card renders exactly as the designer drew it. The request needs no smart object and no artwork. A text-only personalisation is a valid render on its own.

Do it for a list

const recipients = ["Jane", "Alex", "Priya"];

const urls = await Promise.all(recipients.map(async (name) => {
  const res = await fetch(
    "https://api.sudomock.com/api/v1/renders",
    {
      method: "POST",
      headers: {
        "x-api-key": process.env.SUDOMOCK_API_KEY,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        mockup_uuid: "c315f78f-d2c7-4541-b240-a9372842de94",
        text_layers: [
          {
            uuid: "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
            text: `Happy birthday, ${name}`
          }
        ]
      })
    }
  );

  const { data } = await res.json();
  return data.print_files[0].export_path;
}));

One template and a list of names is a run of finished images. Nothing is re-uploaded between them.

Change the typeface too

font, font_size and color are optional on the same entry, and fall back to the layer’s authored values when you leave them out.

{
  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
  "text_layers": [
    {
      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
      "text": "Happy birthday, Jane",
      "font": "Lora-Bold",
      "font_size": 84,
      "color": "#C0392B",
      "fit": "shrink"
    }
  ]
}

font is a catalogue font uuid or its PostScript name, from the 2,000+ family open-licensed catalogue, or from a typeface you uploaded yourself on Pro and Scale. Fonts covers both. fit: "shrink" keeps a long replacement inside the layer’s area rather than letting it run past. Fitting and colour covers the other options, and the outlines and mixed-style layers alongside them.

What to check before you ship

Read three fields from the upload response and you know what a template can do.

is_editable false means the layer keeps its original appearance in this version. The reason and the workaround are in the support matrix on Text layers.
font_available false means the layer’s own typeface is not in your catalogue, so it would fall back. Upload that font, or set font explicitly.
segment_count above 1 means the layer mixes styles and takes segments rather than text.

Text layers

The full override contract, warning codes and support matrix.

Fonts

Browse the catalogue, or upload your brand typeface.

Overview

PSD mockups

Photo mockups

Text and fonts

Integrations

Reference

Advanced

Changes

How to edit PSD text by API

1. Upload the PSD and find the text layers

2. Render with your own wording

Do it for a list

Change the typeface too

What to check before you ship

Text layers

Fonts

​1. Upload the PSD and find the text layers

​2. Render with your own wording

​Do it for a list

​Change the typeface too

​What to check before you ship

Text layers

Fonts

1. Upload the PSD and find the text layers

2. Render with your own wording

Do it for a list

Change the typeface too

What to check before you ship