REST quickstart
From brand kit to a drafted post with curl
You need a token with write and generate scopes (see
Authentication) and jq.
export VST=vst_... # Settings > Developer
export API=https://studio.verber.me/api/v1
# 1. Pick a workspace
WS=$(curl -s -H "Authorization: Bearer $VST" $API/workspaces | jq -r '.data[0].workspaceId')
# 2. Brand kit: extract it from your website (free), then adjust fields
curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
-d '{"url":"https://acme.example"}' $API/workspaces/$WS/brand-kit/from-url
curl -s -X PATCH -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
-d '{"brandToneOfVoice":["friendly"]}' $API/workspaces/$WS/brand-kit
# 3. Import a product page
curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
-d '{"url":"https://acme.example/products/mug"}' $API/workspaces/$WS/products/from-url
# 4. Generate an image (1 credit)
IMG=$(curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
-d '{"prompt":"Acme mug on a sunny desk","aspectRatio":"4:5"}' \
$API/workspaces/$WS/generations/image | jq -r '.data.media.url')
# 5. Draft a post for a connected account
ACC=$(curl -s -H "Authorization: Bearer $VST" $API/workspaces/$WS/social-accounts | jq -r '.data[0].id')
curl -s -X POST -H "Authorization: Bearer $VST" -H 'Content-Type: application/json' \
-d "{\"content\":{\"text\":\"Morning fuel\",\"mediaUrls\":[\"$IMG\"]},\"targets\":[{\"platform\":\"twitter\",\"accountId\":\"$ACC\"}]}" \
$API/workspaces/$WS/postsThe draft appears in Studio's calendar. To schedule or publish it, see Posts.
Next: browse all endpoints.