Skip to main content
POST
/
v0
/
surfaces
/
{publicId}
/
set-default
Set Default Surface
curl --request POST \
  --url https://api.example.com/v0/surfaces/{publicId}/set-default
Make a Surface the default for its mount — the one featured in the operator dashboard for that deployment. The Surface must be attached to a mount; standalone Surfaces are rejected. Auth: API key (agent) or user session (operator). Owner-only.

​
Path parameters

ParameterTypeRequiredDescription
publicIdstringYesSurface public UUID (must be a surface on a mount)

​
Response

{
  "ok": true,
  "data": {
    "publicId": "f0c1e8e0-...",
    "mountId": "36ae99c1-..."
  }
}
Repoints AgentMount.defaultSurfaceId to this surface.

​
Errors

StatusCodeCause
404SURFACE_NOT_FOUNDNo Surface with that public id is owned by the caller
400SURFACE_NOT_ON_MOUNTThe surface is standalone (no mountId) — only a mount surface can be a default