Update surface
Update an existing surface. Supports partial updates with shallow-merge for behavior.
Authentication
AuthorizationBearer
API key or Clerk session token
Path parameters
id
surfaceId
Request
This endpoint expects an object.
behavior
config
inbound
name
outbound
status
Allowed values:
Response
Surface updated
createdAt
endpoint
Canonical public URL of this surface (MCP, API, A2A, AG-UI, webhook, chat). Null for surface types reached through their own channels (Slack, email, schedule, …). Clients should use this instead of constructing the URL themselves.
id
name
productId
status
type
updatedAt
webhookHealth
behavior
inbound
outbound
warnings
Advisory findings about this surface configuration. Present only when non-empty; never blocks the mutation.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error