Generate Presigned Url

PUT 
/api/v1/files

Create a presigned url for uploading a file.

Request

Query Parameters

project_id any
organization_id any

Cookie Parameters

session any

application/json

Body

required

name Name (string)required

Possible values: non-empty and <= 3000 characters

external_file_id

object

The ID of the file in the external system

anyOf

MOD1

string

file_size

object

Size of the file in bytes

anyOf

MOD1

integer

last_modified_at

object

The last modified time of the file

anyOf

MOD1

string

resource_info

object

Resource information for the file

anyOf

MOD1

property name*

object

anyOf

MOD1

object

MOD2

Array [

]

MOD3

string

MOD4

integer

MOD5

number

MOD6

boolean

permission_info

object

Permission information for the file

anyOf

MOD1

property name*

object

anyOf

MOD1

object

MOD2

Array [

]

MOD3

string

MOD4

integer

MOD5

number

MOD6

boolean

data_source_id

object

The ID of the data source that the file belongs to

anyOf

MOD1

string

Responses

200

Successful Response

application/json

Schema

Schema

url urirequired

A presigned URL for IO operations against a private file

Possible values: non-empty

expires_at date-timerequired

The time at which the presigned URL expires

form_fields

object

Form fields for a presigned POST request

anyOf

MOD1

property name* string

Example (from schema)

{
  "url": "string",
  "expires_at": "2024-07-29T15:51:28.071Z",
  "form_fields": {}
}

422

Validation Error

application/json

Schema

Schema

detail

object[]

Array [

loc

object[]

required

Array [

anyOf

MOD1

string

MOD2

integer

]

msg Message (string)required

type Error Type (string)required

]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}