Dokki API logo
PATCH
/api/v1/resources/{resource_id}/form

Update form

PATCH /api/v1/resources/{resource_id}/form

Update a table collection form. This endpoint has the same request body and response shape as POST /api/v1/resources/{resource_id}/form.

Endpoint

  • Method: PATCH

  • Path: /api/v1/resources/{resource_id}/form

  • Required scope: form:write

  • Base URL: https://dokki.one

Request body

  • config — replace the form configuration with title, optional description, and field definitions.

  • is_active — boolean. isActive is also accepted.

  • rotate_webhook_token — boolean. rotateWebhookToken is also accepted.

Webhook rotation immediately invalidates the old webhook URL. The resource must be a table, and the caller needs current write and manage access.

Request example

curl -X PATCH "https://dokki.one/api/v1/resources/$TABLE_RESOURCE_ID/form" \
  -H "Authorization: Bearer $DOKKI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "rotate_webhook_token": true }'

Response

Returns 200 with resource, resolved access, and the updated form. The response includes sensitive form and webhook tokens; do not return it to a browser or store it in application logs.

Errors

  • 400 — no update field was supplied, the resource is not a table, or a value is invalid.

  • 401 — missing or invalid API key.

  • 403 — API key lacks form:write, write access, or manage access.

  • 404 — resource is unavailable to the caller.