List the relations touching a database
Returns every relation with an end on this database, including the database and field at the far end, both cardinalities, the configured delete behavior, and a `near` marker naming the end this database owns. Requires the `databases:read` permission.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/databases/string/relations"{ "data": [ { "id": "string", "workspaceId": "string", "label": "string", "fromDatabaseId": "string", "fromFieldId": "string", "fromCardinality": "one", "toDatabaseId": "string", "toFieldId": "string", "toCardinality": "one", "onDelete": "detach", "createdAt": "string", "updatedAt": "string", "near": "from" } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Preview what deleting a view would affect
Returns the blocks, automations and other references that depend on the view, with an overall status of `safe`, `needs_confirmation`, or `blocked`. Read-only. Requires the `databases:write` permission.
Update a relation's label and delete behavior
Renames the link and changes its `onDelete` behavior; the two ends, their fields and their cardinalities are immutable. Requires the `databases:write` permission on both databases the relation joins, and responds with not-found when the relation has no end on the database in the path. Send an `Idempotency-Key` header to make retries safe; a replay within the window returns the original response.