API referenceEndpoints

Refresh surface

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/surfaces/inbound/http.go`.

POST/v1/surfaces/{id}/refresh

Requires an authenticated tenant principal. Generated from the production route registered in internal/features/surfaces/inbound/http.go.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/surfaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/refresh"
{  "refresh_id": "a3a6f8f8-2a0d-41dc-8d28-95b2765019aa",  "state": "queued"}