Skip to main content
POST
/
v1
/
schemas
/
{schemaName}
/
refresh-metadata
Refresh schema metadata
curl --request POST \
  --url https://api.dynamosql.com/v1/schemas/{schemaName}/refresh-metadata \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "ok": true,
    "message": "Refresh complete. 5 table(s) refreshed, 0 failed, 1 deleted.",
    "refreshedAt": "2026-03-11T10:00:00.000Z",
    "tableCount": 5,
    "failedTableCount": 0,
    "deletedCount": 1,
    "skipped": false
  }
}
Required scope: schemas:write

Authorizations

​
Authorization
string
header
required

Bearer token obtained from POST /v1/auth/token. Pass in the Authorization header as Bearer <token>.

Path Parameters

​
schemaName
string
required

The schema name to refresh.

Response

Refresh attempted. Check data.ok for success or partial failure. A 200 response does not guarantee all tables were refreshed successfully.

​
success
boolean
required

true when the request was processed without errors, false otherwise. Always present.

​
data
object
​
error
object

Present in the response body when success is false.