warehouse_tables

Upload a file for a new self-managed warehouse table

Store an uploaded file in object storage so a self-managed table can be created from it.

Uploading is a separate first step from create_from_upload so the create call stays JSON-only: this returns an upload_id the caller passes back to build the table. The file is written under a team-scoped prefix, so a table can only ever read back its own team's uploads.

post/api/projects/{project_id}/warehouse_tables/upload_file/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/warehouse_tables/upload_file/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Response

upload_idstring uuid required

Id of the stored upload. Pass it to create_from_upload to build the table.

filenamestring required

Sanitized name the file was stored under.

file_formatstring required

Format the file will be read as: 'csv', 'json', or 'parquet'.

size_bytesinteger required

Size of the stored file in bytes.

Changes

No recorded changes to this operation across all 1 revision of this API.