Say where you left an import

PUT

/orgs/{org}/imports/{id}/mine/position

curl --request PUT \
  --url https://api.sloose.com/orgs/org_9f3c/imports/imp_4d1a/mine/position \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "part": { "kind": "connection" }, "version": 1 }'

• Production
• Staging

The part the person is on, kept so the import reopens there for them rather than wherever a colleague last was. Written over the last. A part of one file is recorded only while the import holds that file as read at version — the answer says whether it was (held). Moves no version, and no run refuses it; the import’s own step, which the Imports list shows, is changed with the import.

Authorizations

• sessionAuth

Parameters

Path Parameters

org

required

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

string

Example

org_9f3c

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

id

required

The import id.

string

Example

imp_4d1a

The import id.

Request Body^required

Media typeapplication/json

object

part

required

One of:

object

object

kind

required

string

Allowed values: connection

object

object

kind

required

string

Allowed values: modules

object

object

kind

required

string

Allowed values: source

source

required

string

/^[A-Za-z0-9_-]{1,64}$/

object

object

kind

required

string

Allowed values: rows

source

required

string

/^[A-Za-z0-9_-]{1,64}$/

module

required

string

>= 1 characters <= 200 characters

object

object

kind

required

string

Allowed values: cols

source

required

string

/^[A-Za-z0-9_-]{1,64}$/

module

required

string

>= 1 characters <= 200 characters

object

object

kind

required

string

Allowed values: vals

module

required

string

>= 1 characters <= 200 characters

object

object

kind

required

string

Allowed values: checks

object

object

kind

required

string

Allowed values: run

null

null

version

required

The import’s version the page was at. A part of a file read since — replaced, read under new options, or added again under the id — or of a file the import does not hold is not recorded, and the answer says so.

integer

Responses

200

Answered.

Media typeapplication/json

object

ok

required

boolean

held

required

Whether it was recorded. False when the part is of a file the import does not hold — often not yet, since a page is on a file its own changes have still to upload — or holds only as read since version: send it again once it does.

boolean

Example

{
  "ok": true
}

400

The request — its body or its query — did not match the schema. issues carries the Zod issue list.

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"
}

401

No bearer, or one that is expired, revoked or no longer resolves to a member.

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 bearer is an API token (SESSION_REQUIRED), a read-only staff view (IMPERSONATION_READ_ONLY) or a staff view that may write (STAFF_VIEW: what a person keeps is theirs), or was issued for a different org.

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 not one this bearer may open (IMPORT_NOT_FOUND).

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"
}