v1

latestOpenAPI 3.0.3Proprietary2026-07-26162247330.6 KB

Branch

Retrieve anonymized branch status

Retrieves the current status of an anonymized branch, including its state and progress information. This endpoint allows you to monitor the anonymization process from initialization through completion. Only anonymized branches will have status information available.

Note: This endpoint is currently in Beta.

get/projects/{project_id}/branches/{branch_id}/anonymized_status

Response

Anonymized branch status retrieved successfully

project_idstring required

The ID of the project

branch_idstring required

The ID of the anonymized branch

statestring required

The current state of the anonymized branch. Possible values: created, initialized, initialization_error, anonymizing, anonymized, error

status_messagestring

A descriptive message about the current status or any errors

created_atstring date-time required

A timestamp indicating when the anonymized branch was created

updated_atstring date-time required

A timestamp indicating when the anonymized branch status was last updated

failed_atstring date-time

A timestamp indicating when the anonymized branch operation failed (if applicable)

Example response

{
  "branch_id": "br-aged-salad-637688",
  "project_id": "simple-truth-637688",
  "state": "anonymizing",
  "status_message": "Anonymizing table mydb.public.users (3/5)",
  "created_at": "2022-11-30T18:25:15Z",
  "updated_at": "2022-11-30T18:30:22Z",
  "last_run": {
    "started_at": "2022-11-30T18:25:15Z",
    "completed_at": "2022-11-30T18:30:22Z",
    "triggered_by": "df6c5f70-6cbf-4c8c-9e7a-74c3ddbd8f9f",
    "masked_columns": 12
  }
}