Project Archives

Get portable archive export status

Read archive export status. Authorization is checked on every read; unauthorized callers receive 403 without an existence oracle. For ready archives, this refreshes the short-lived download_authorized_until window and returns download_url.

get/projects/v1/{project_id}/archives/{archive_id}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/archives/{archive_id}
  • Auth: one of:
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer
    • HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042
archive_idstring required

Response

Archive status.

archive_idstring required
operation_idstring required

Same value as archive_id in v1; archive generation is always operation-backed.

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

status'running' | 'ready' | 'failed' | 'expired' required
format_version'run402-project-archive.v1' required
scope'portable-runtime-v1' required
auth_export'none' | 'stubs' required
consistency_mode'cloud_write_pause_v1' required
active_release_idstring nullable required
consistencyobject required
errorobject nullable required
byte_countinteger nullable required
sha256string nullable required

Hex SHA-256 digest of the downloadable archive tar bytes.

content_typestring nullable required
download_urlstring nullable required
download_authorized_untilstring date-time nullable required

Short-lived download authorization timestamp. GET status refreshes it for ready archives.

expires_atstring date-time required

Archive retention expiration timestamp, 24 hours after creation in v1.

started_atstring date-time required
completed_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "archive_id": "archive_1782450000000_ab12cd34",
  "project_id": "prj_1741340000_0042",
  "export_report": {
    "schema_version": "run402.project_archive.export_report.v1",
    "export_scope": "portable-runtime-v1",
    "consistency": "cloud_write_pause_v1"
  },
  "portability_report": {
    "schema_version": "run402.project_archive.portability_report.v1",
    "entries": [
      {
        "code": "SECRET_VALUES_REQUIRED",
        "resource_type": "secret"
      }
    ]
  },
  "content_type": "application/x-tar",
  "download_url": "/projects/v1/prj_.../archives/archive_.../download"
}

Changes

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