Upload Extension | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/browser-extensions/upload \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: multipart/form-data" \
     -F file=@UEsDBBQACAgIAK1a1VIAAAAAAAAAAAAAAAAJABwAbrowser_extension.crxUEsBAhQAFAAICAgArVrVSAAAAAAAAAAAAAAAAAAkAGAAAAAAAAAAQAAAABAAAAAAABb3B0aW9uYWwgbmFtZQ==

{
  "createdAt": "2024-01-15T09:30:00Z",
  "format": "crx",
  "id": "ext_AbC123_XyZ",
  "name": "My Awesome Extension",
  "profileCount": 42,
  "updatedAt": "2024-01-15T09:30:00Z",
  "version": "1.2.3",
  "contentHash": "sha256:3a7bd3e2360a3f4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b",
  "sizeBytes": 1048576,
  "sourceUrl": "https://extensions.example.com/my-awesome-extension.crx",
  "subaccountId": "org_12345_subaccount_67890"
}

Upload a browser extension package and return the simplified browser extension resource.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects a multipart form containing a file.

filefileRequired

Chromium browser extension package (.crx).

namestringOptional

Optional display name. Defaults to manifest.name.

subaccountIdstringOptional

Parent/org keys may create the extension inside a subaccount. Subaccount keys are auto-scoped.

Response

Created

createdAtdatetime

format"crx"

idstringformat: "^ext_[A-Za-z0-9_-]+$"

namestring>=1 character

profileCountinteger0-9007199254740991

updatedAtdatetime

versionstring>=1 character

contentHashstringformat: "^sha256:[a-f0-9]{64}$"

sizeBytesinteger0-9007199254740991

sourceUrlstringformat: "uri"

subaccountIdstring>=1 character

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error