Remove a file

DELETE

/orgs/{org}/imports/{id}/files/{fid}

curl --request DELETE \
  --url https://api.sloose.com/orgs/org_9f3c/imports/imp_4d1a/files/fil_7c2e \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

The sheet no longer names it. A file no run used is deleted after a day; one a run used goes at that use plus the plan’s days, never waiting on run history. Removing is not undoable; uploading again is a new file.

Authorizations

• sessionAuth
• apiTokenAuth

Parameters

Path Parameters

org

required

The organisation id the session was issued for. A token for one organisation can never read another.

string

Example

org_9f3c

The organisation id the session was issued for. A token for one organisation can never read another.

id

required

The import id.

string

Example

imp_4d1a

The import id.

fid

required

The file id.

string

Example

fil_7c2e

The file id.

Responses

200

The file, now removed.

Media typeapplication/json

object

id

required

string

state

required

string

Allowed values: reserved committed attached removed deleting

size

required

The stored size in bytes, read from storage at commit; null until then.

integer | null

declaredSize

required

integer

contentType

required

Read from the file’s first bytes by the server, never from its name or the browser’s claim.

string | null

sha256

required

The content’s SHA-256 (base64), as the browser said it. See sha256Verified.

string | null

sha256Verified

required

True where storage checked it (a single signed PUT); false where it is the browser’s claim (a multipart file, whose parts are each verified by their MD5).

boolean

Example

{
  "state": "reserved"
}

401

No bearer, or one that no longer resolves: a session that is unknown or expired (code: AUTH_REQUIRED), or an API token that was revoked or expired (TOKEN_REVOKED, TOKEN_EXPIRED), whose organisation is gone (ORG_NOT_FOUND) or whose member or user row is (MEMBERSHIP_GONE).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

403

The role or session. Like every route behind a session: a session signed in but in no organisation is refused code: NO_ORG, a banned person code: BANNED, and a closed organisation code: ORG_CLOSED.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

404

No such import or file.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

409

Not a stored file (FILE_NOT_STORED).

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

503

The restore switch is on (code: MAINTENANCE): every route but /health and /robots.txt is refused before anything is read, except the operator’s own POST /staff/people/{id}/delete with the ADMIN_TOKEN. Sloose is down for maintenance. Please try again in a few minutes.

Media typeapplication/json

object

error

required

string

code

required

string

Allowed value: MAINTENANCE

Example

{
  "code": "MAINTENANCE"
}

Headers

Retry-After

integer

Seconds until asking again is worth it (300 while the switch is on).