zone.stratos.repo.importRepo Documentation (EN)

main procedure

Import a repository from a CAR file. Verifies record CID integrity and re-signs with the destination service key. The caller must be enrolled as the DID in the CAR's commit block.

Input

Encodingapplication/vnd.ipld.car

Accepts raw binary data

Output

Encodingapplication/json

imported integer Required

Number of records successfully imported.

Errors

InvalidCar The CAR file is malformed, has missing blocks, or contains records with mismatched CIDs.

RepoAlreadyExists The destination already has records for this DID. Import is only supported for empty repos.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "encoding": "application/vnd.ipld.car"
  },
  "errors": [
    {
      "name": "InvalidCar",
      "description": "The CAR file is malformed, has missing blocks, or contains records with mismatched CIDs."
    },
    {
      "name": "RepoAlreadyExists",
      "description": "The destination already has records for this DID. Import is only supported for empty repos."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "imported"
      ],
      "properties": {
        "imported": {
          "type": "integer",
          "description": "Number of records successfully imported."
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Import a repository from a CAR file. Verifies record CID integrity and re-signs with the destination service key. The caller must be enrolled as the DID in the CAR's commit block."
}