Skip to content

Extensions API

Beta

Set up your agent

Give your coding agent a Steel browser and the Steel skills, so that it browses and writes Steel code the right way. Learn more

Install the Steel CLI. It signs you in and installs the skills for your coding agents.

curl -fsS https://setup.steel.dev | sh

Or send this prompt to your coding agent, and it does the same:

Read https://setup.steel.dev/install.md and follow it to set up Steel for this coding client.
Then continue my requested task using the installed Steel skill.

Set up your agent →

Steel stores the Chrome extensions that your organization uploads, and a session installs one when you pass its ID in extensionIds. These endpoints upload, list, download, update and delete extensions. For the base URL and authentication, see API conventions. For the error codes, see Errors.

The first example is a complete program that uploads extension.zip from the current folder. The later examples use its client, and the ID of an extension in EXTENSION_ID (cURL), extensionId (TypeScript), extension_id (Python and Rust) or extensionID (Go).

Endpoints

Upload an extension

POST/v1/extensions

Uploads a Chrome extension from a .zip or .crx file, or from its Chrome Web Store URL. The request is multipart/form-data. Send file or url.

Parameters

NameTypeRequiredDescription
filefile · bodyNoThe extension, as a .zip or .crx file.
urlstring (uri) · bodyNoThe Chrome Web Store URL of the extension.

The response is 201:

Response

FieldTypeDescription
idstringThe Chrome extension ID: 32 letters from a to p, such as mjoedlfflcchnleknnceiplgaeoegien.
namestringThe name of the extension.
createdAtstringWhen the extension was uploaded.
updatedAtstringWhen the extension last changed.

See Extensions.

curl -X POST https://api.steel.dev/v1/extensions \
  -H "steel-api-key: $STEEL_API_KEY" \
  -F "file=@extension.zip"

List extensions

GET/v1/extensions

Lists your organization's extensions.

This endpoint takes no parameters.

Response

FieldTypeDescription
extensionsobject[]The extensions, each with id, name, createdAt and updatedAt.
countnumberThe total number of extensions.

See Extensions.

curl https://api.steel.dev/v1/extensions \
  -H "steel-api-key: $STEEL_API_KEY"

Download an extension

GET/v1/extensions/{extensionId}

Downloads one extension.

Parameters

NameTypeRequiredDescription
extensionIdstring · pathYesThe ID of the extension.

The response is the extension as a ZIP file, application/zip.

See Extensions.

curl https://api.steel.dev/v1/extensions/$EXTENSION_ID \
  -H "steel-api-key: $STEEL_API_KEY" \
  -o extension.zip

Update an extension

PUT/v1/extensions/{extensionId}

Replaces an extension with a new .zip or .crx file, or with a Chrome Web Store URL. The request is multipart/form-data. Send file or url.

Parameters

NameTypeRequiredDescription
extensionIdstring · pathYesThe ID of the extension.
filefile · bodyNoThe new extension, as a .zip or .crx file.
urlstring (uri) · bodyNoThe Chrome Web Store URL of the extension.

The response has the fields in Upload an extension.

See Extensions.

curl -X PUT https://api.steel.dev/v1/extensions/$EXTENSION_ID \
  -H "steel-api-key: $STEEL_API_KEY" \
  -F "file=@extension.zip"

Delete an extension

DELETE/v1/extensions/{extensionId}

Deletes one extension.

Parameters

NameTypeRequiredDescription
extensionIdstring · pathYesThe ID of the extension.

Response

FieldTypeDescription
messagestringA message about the result.

See Extensions.

curl -X DELETE https://api.steel.dev/v1/extensions/$EXTENSION_ID \
  -H "steel-api-key: $STEEL_API_KEY"

Delete all extensions

DELETE/v1/extensions

Deletes every extension of your organization.

This endpoint takes no parameters.

Response

FieldTypeDescription
messagestringA message about the result.

See Extensions.

curl -X DELETE https://api.steel.dev/v1/extensions \
  -H "steel-api-key: $STEEL_API_KEY"