export_project

Queue a portable .btx archive export for a Bridge Town project. Poll get_export(job_id) for completion and the pre-signed download URL. Returns: job_id (str) — export job UUID; status (str) — queued/pending status; project_id (str) — project slug; message (str) — next action; warning (str|null) — optional clamping or staging warning.

Parameters

Name	Type	Required	Default	Description
project_id	Annotated[str, Field(description='UUID or name of the project to export.')]	Yes	—
include_runs	Annotated[int, Field(description='When true, include model run history in the export archive.')]	No	5
include_dashboards	Annotated[bool, Field(description='When true, include dashboard configurations in the export archive.')]	No	True

Returns

Returns a structured object. Top-level fields:

• job_id (string)
• status (string)
• project_id (string)
• message (string)
• warning (null)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "export_project",
  "arguments": {
    "project_id": "forecasts",
    "include_runs": 5,
    "include_dashboards": true
  }
}

Response

{
  "job_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
  "status": "queued",
  "project_id": "forecasts",
  "message": "Export queued.",
  "warning": null
}

Notes

• Module: Exports
• Requires authentication via API token or Auth0 JWT.