Skip to main content
Edit an application using natural language
curl --request POST \
  --url https://sapi.withsutro.com/applications/{applicationId}/slang-edit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-sutro-api-client: <api-key>' \
  --data '
{
  "prompt": "<string>"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "implementationJobId": "<string>",
  "jobType": "figma_code_generation",
  "status": "queued",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "metadata": {},
  "errorMessage": "<string>",
  "errorStack": "<string>",
  "startedAt": "<string>",
  "completedAt": "<string>"
}

Authorizations

​
Authorization
string
header
required

Builder authentication and authorization

​
x-sutro-api-client
string
header
required

A unique identifier for the API Client making a request

Path Parameters

​
applicationId
string<uuid>
required

Body

application/json
​
prompt
string
required

The natural language edit instruction

Response

Edit job accepted and queued for processing

​
id
string<uuid>
required

The job ID

​
implementationJobId
string
required

The implementation job ID

​
jobType
enum<string>
required

The type of job

Available options:
figma_code_generation,
application_generation,
follow_up_change,
slang_edit,
test
​
status
enum<string>
required

The current status of the job

Available options:
queued,
active,
completed,
failed,
cancelled
​
customerId
string<uuid>
required

The customer ID

​
projectId
string<uuid>
required

The project ID

​
metadata
object

Job-specific metadata (structure depends on jobType)

​
errorMessage
string | null

Error message if the job failed

​
errorStack
string | null

Error stack trace if the job failed

​
startedAt
string | null

When the job started

​
completedAt
string | null

When the job completed