API Reference

Delete Table Import

DELETE/api/v2/connectivity/connections/{connectionRid}/tableImports/{tableImportRid}

Warning

This endpoint is in preview and may be modified or removed at any time. To use this endpoint, add preview=true to the request query parameters.

Delete the TableImport with the specified RID. Deleting the table import does not delete the destination dataset but the dataset will no longer be updated by this import.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:connectivity-table-import-write.

Path parameters

connectionRid

string

The Resource Identifier (RID) of a Connection (also known as a source).

tableImportRid

string

The Resource Identifier (RID) of a TableImport (also known as a batch sync).

Query parameters

preview

boolean

optional

Enables the use of preview functionality.

Examples

Request

Copied!

curl -X DELETE \
	-H "Authorization: Bearer $TOKEN" \
	"https://$HOSTNAME/api/v2/connectivity/connections/ri.magritte..source.c078b71b-92f9-41b6-b0df-3760f411120b/tableImports/ri.magritte..extract.27bb4f2b-63b8-44b8-a579-4e2bd65ba158?preview=true"

Error responses

Error Name
`DeleteTableImportPermissionDenied`	Error Code	`PERMISSION_DENIED`
	Status Code	403
	Description	Could not delete the TableImport.
	Parameters	`tableImportRid, connectionRid`

See Errors for a general overview of errors in the platform.