Skip to main content
Projects hold the data, files, and knowledge Addison works from. Everything an Addison conversation can see is scoped to one project, so most integrations start here: create or find a project, put files in it, attach the tables you want visible. Product-side docs: Projects. Excel workbooks and HTML artifacts are ordinary project files: read and write them with the file-content endpoints below, not a dedicated API. See Excel and HTML.

​
Open and edit

GET /v1/projects/{project_id}/files/{file_id}/content

Download the workbook’s content.

PUT /v1/projects/{project_id}/files/content

Create or overwrite the workbook’s content. Send the binary .xlsx with encoding: "base64" (raw bytes corrupt the file), and supply exactly one of path or file_id.

​
Manage as a file

GET /v1/projects/{project_id}/files/{file_id}/content

Download the workbook.

DELETE /v1/projects/{project_id}/files/{file_id}

Delete the workbook. Requires confirm=true.

​
Open and view

GET /v1/projects/{project_id}/files/{file_id}/content

Download the page’s HTML.

PUT /v1/projects/{project_id}/files/content

Create or overwrite the page’s HTML.

​
Manage as a file

GET /v1/projects/{project_id}/files/{file_id}/content

Download the page.

DELETE /v1/projects/{project_id}/files/{file_id}

Delete the page. Requires confirm=true.

​
Files

GET /v1/projects/{project_id}/files

List or search files.

GET /v1/projects/{project_id}/files/{file_id}

Show a file’s metadata.

GET /v1/projects/{project_id}/files/{file_id}/content

Download a file’s content.

PUT /v1/projects/{project_id}/files/content

Create or overwrite a file’s content.

DELETE /v1/projects/{project_id}/files/{file_id}

Delete a file. Requires confirm=true.

​
Default project

GET /v1/projects/default

Get your default project.

​
Find and open a project

GET /v1/projects

List projects.

GET /v1/projects/{project_id}

Fetch a single project.

​
Create a project

POST /v1/projects

Create a project.

​
Rename or edit a project

PATCH /v1/projects/{project_id}

Update a project’s name, description, or visibility. Changing visibility requires that you be an Owner or Manager. visibility accepts only private or public; setting it public shares the project org-wide with Editor access. There’s no view-only option on this endpoint, so use the Share dialog for org-wide read-only.

​
Delete a project

DELETE /v1/projects/{project_id}

Delete a project. Requires confirm=true.

​
Import

POST /v1/projects/{project_id}/files/uploads

Create a presigned upload.

POST /v1/projects/{project_id}/files/uploads/{upload_id}/finalize

Finalize the upload.

POST /v1/projects/{project_id}/files/{file_id}/imports

Import the finalized file into an analyzable table, required before a CSV can be queried. The curated MCP tool is import_file_to_table.

POST /v1/projects/{project_id}/catalog-entries

Attach a table or view to the project’s catalog.

GET /v1/projects/{project_id}/catalog-entries

List the tables and views attached to the project.

POST /v1/projects/{project_id}/catalog-entries/{catalog_entry_id}/refreshes

Refresh a catalog entry’s schema from its source table or view.

DELETE /v1/projects/{project_id}/catalog-entries/{catalog_entry_id}

Detach a table or view from the project.
Attaching a data connection links an existing tenant-wide table or view into the project’s catalog (the curated MCP tool is attach_catalog_entry):