Create Table Import Part URLs

Issue short-lived signed PUT URLs for a bounded set of multipart part numbers.

The import must still be in the uploading state. An import that has moved on — including one that has expired — returns 409 naming the current status; a purged or unknown import id returns 404.

POST/api/v2/tables/imports/{importId}/parts

Authorization

apiKey
X-API-Key<token>

Your Sim API key, personal or workspace-scoped. Generate one from the Sim dashboard under Settings > API Keys. A workspace API key is not accepted everywhere: operations that act on behalf of a specific human — administrative reads, secret access, and irreversible or governance-affecting writes — always reject it, whatever role the key carries. Each such operation says so in its own description, and the rejection surfaces as 403 unless the operation conceals unauthorized resources, in which case it is reported as 404. Use a personal API key for those.

In: header

Path Parameters

importId*string

Unique table-import identifier.

Length1 <= length

Query Parameters

workspaceId*string

Workspace that owns the transfer resource.

Length1 <= length

Header Parameters

upload-token*string

Signed upload control token returned when the upload session was created.

Length1 <= length

Request Body

application/json

Multipart part numbers for which signed URLs should be created.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://www.sim.ai/api/v2/tables/imports/string/parts?workspaceId=string" \  -H "upload-token: string" \  -H "Content-Type: application/json" \  -d '{    "partNumbers": [      1,      2,      3    ]  }'
{
  "data": {
    "parts": [
      {
        "partNumber": 1,
        "url": "http://example.com",
        "headers": {
          "property1": "string",
          "property2": "string"
        },
        "expiresAt": "2019-08-24T14:15:22Z"
      }
    ]
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "The request is invalid."
  }
}