Update a siteComing soon
Changes the site’s name, tagline, description, top image, contact details or socials. A published site updates straight away.
Coming soon. Changes the site’s name, tagline, description, top image, contact details or socials. A published site updates straight away.
Scopes: sites:write
Pricing: Included with the connection.
AuthorizationBearer <matchai_<base62>>A personal API key, sent as Authorization: Bearer matchai_…. Create keys in Matchai under Settings → Connectors → Advanced (for developers). A key starts with matchai_ followed by letters and digits, carries the scopes chosen when it was created, and can be revoked at any time. Keys reach only the account that created them: to serve other professionals, use Connect with Matchai.
Scope: sites:write
site_id*stringSite id.
1 <= length <= 64application/json- body
1 <= propertiesname?|Site name.
length <= 120tagline?|Tagline.
length <= 160description?|About the site.
length <= 4000hero_image_url?|A publicly reachable image to copy in as the top image.
uricontact_email?|Contact email.
emailcontact_phone?|Contact phone, E.164.
^\+[1-9][0-9]{6,14}$social_links?Public profile links. Every key is optional.
The site.
application/json- response
A Matchai Site: a portfolio website made of listing pages.
id*stringSite id.
1 <= length <= 64subdomain*stringThe site lives at {subdomain}.matchai.co.
url*stringThe site’s primary address: the custom domain when one is active.
uricustom_domain?|nullname?|Site name.
tagline?|Short line under the name.
description?|About the site.
hero_image_url?|Top image.
uricontact_email?|Contact email shown on the site.
emailcontact_phone?|Contact phone shown on the site, E.164.
social_links*Public profile links. Every key is optional.
published*booleanWhether the site is on the public web.
owner*Who owns a listing or a site: one professional, or a team.
listing_count*integerListings on the site.
0 <= valuecreated_at*stringCreated.
date-timeupdated_at*stringLast changed.
date-timecurl -X PATCH 'https://api.matchai.co/v1/sites/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "subdomain": "string", "url": "http://example.com", "custom_domain": { "hostname": "string", "status": "pending" }, "name": "string", "tagline": "string", "description": "string", "hero_image_url": "http://example.com", "contact_email": "user@example.com", "contact_phone": "string", "social_links": { "website": "http://example.com", "linkedin": "http://example.com", "instagram": "http://example.com", "facebook": "http://example.com", "x": "http://example.com", "youtube": "http://example.com", "tiktok": "http://example.com" }, "published": true, "owner": { "type": "user", "id": "string", "name": "string" }, "listing_count": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}