Skip to main content
DELETE
/
v2
/
imports
/
sessions
/
{import_id}
Delete Import Session
const options = {
  method: 'DELETE',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v2/imports/sessions/{import_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

​
Delete Import Session

Delete an import session that has not been submitted. This removes all cached rows, validation data, and associated S3 artifacts.
This action is permanent. Submitted sessions cannot be deleted — only non-submitted sessions can be cleaned up.

​
Request

​
Headers

​
x-api-key
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
​
x-organization-id
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

​
Path Parameters

​
import_id
string
required
UUID of the import session to deleteExample: "11111111-1111-1111-1111-111111111111"

​
Response

Returns HTTP 204 No Content on success.

​
Example

curl -X DELETE "https://api.dcycle.io/v2/imports/sessions/11111111-1111-1111-1111-111111111111" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

​
Common Errors

​
401 Unauthorized

Cause: Missing or invalid API key 
{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

​
403 Forbidden

Cause: The authenticated user is not a member of the organization 
{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}

​
400 Bad Request

Cause: Session has already been submitted and cannot be deleted 
{
  "detail": "Cannot delete a submitted import session."
}

​
404 Not Found

Cause: Session does not exist or does not belong to your organization 
{
  "detail": "Not found."
}

Create Session

Start a new import

List Sessions

View all import sessions