---
site: steel.dev
collection: docs
canonical_url: https://steel.dev/docs/reference/api/extensions
markdown_url: https://steel.dev/docs/reference/api/extensions.md
content_signal: ai-input=yes, ai-train=yes, search=yes
title: Extensions API
description: Upload, list, download, update and delete the Chrome extensions that your sessions install, with the Steel API.
summary: Upload, list, download, update and delete the Chrome extensions that your sessions install, with the Steel API.
type: reference
stage: beta
reviewed: 2026-11-12
prerequisites: []
related:
  - https://steel.dev/docs/reference/api/profiles.md
  - https://steel.dev/docs/reference/api/credentials.md
  - https://steel.dev/docs/reference/api/files.md
  - https://steel.dev/docs/reference/api/projects.md
  - https://steel.dev/docs/reference/api/api-keys.md
agent_setup: https://setup.steel.dev/install.md
docs_index: https://steel.dev/docs/sitemap.md
---

# Extensions API

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](https://steel.dev/docs/reference/api). For the error codes, see [Errors](https://steel.dev/docs/reference/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

```http
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`.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `file` | body | file | no | | The extension, as a `.zip` or `.crx` file. |
| `url` | body | string (uri) | no | | The Chrome Web Store URL of the extension. |

The response is `201`:

| Field | Type | Description |
| - | - | - |
| `id` | string | The Chrome extension ID: 32 letters from `a` to `p`, such as `mjoedlfflcchnleknnceiplgaeoegien`. |
| `name` | string | The name of the extension. |
| `createdAt` | string | When the extension was uploaded. |
| `updatedAt` | string | When the extension last changed. |

**cURL**

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

**TypeScript**

```ts file=upload-extension.mts
import { createReadStream } from "node:fs";
import Steel from "steel-sdk";

const client = new Steel();
const extension = await client.extensions.upload({
  file: createReadStream("extension.zip"),
});

console.log(extension.id);
```

**Python**

```python file=upload-extension.py
from pathlib import Path

from steel import Steel

client = Steel()
extension = client.extensions.upload(file=Path("extension.zip"))

print(extension.id)
```

**Go**

```go file=main.go
package main

import (
	"context"
	"fmt"
	"io"
	"log"
	"os"

	"github.com/steel-dev/sdk/go"
)

func main() {
	if err := run(context.Background()); err != nil {
		log.Fatal(err)
	}
}

func run(ctx context.Context) error {
	client := steel.NewClient()
	file, err := os.Open("extension.zip")
	if err != nil {
		return err
	}
	defer file.Close()

	extension, err := client.Extensions.Upload(ctx, steel.ExtensionUploadParams{
		File: steel.F[io.Reader](file),
	})
	if err != nil {
		return err
	}

	fmt.Println(extension.ID)
	return nil
}
```

**Rust**

```rust file=src/main.rs
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = steel_rs::Client::new();
    let file = steel_rs::Upload::open("extension.zip").await?;
    let extension = client
        .extensions()
        .upload(steel_rs::ExtensionUploadParams {
            file: Some(file),
            ..Default::default()
        })
        .await?;

    println!("{}", extension.id);
    Ok(())
}
```

See [Extensions](https://steel.dev/docs/sessions/extensions).

### List extensions

```http
GET /v1/extensions
```

Lists your organization's extensions.

This endpoint takes no parameters.

| Field | Type | Description |
| - | - | - |
| `extensions` | object\[] | The extensions, each with `id`, `name`, `createdAt` and `updatedAt`. |
| `count` | number | The total number of extensions. |

**cURL**

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

**TypeScript**

```ts
const { extensions } = await client.extensions.list();

for (const extension of extensions) {
  console.log(extension.id, extension.name);
}
```

**Python**

```python
result = client.extensions.list()

for extension in result.extensions:
    print(extension.id, extension.name)
```

**Go**

```go
result, err := client.Extensions.List(ctx)
if err != nil {
	return err
}

for _, extension := range result.Extensions {
	fmt.Println(extension.ID, extension.Name)
}
```

**Rust**

```rust
let result = client.extensions().list().await?;

for extension in result.extensions {
    println!("{} {}", extension.id, extension.name);
}
```

See [Extensions](https://steel.dev/docs/sessions/extensions).

### Download an extension

```http
GET /v1/extensions/{extensionId}
```

Downloads one extension.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `extensionId` | path | string | yes | | The ID of the extension. |

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

**cURL**

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

**TypeScript**

```ts
import { writeFile } from "node:fs/promises";

const archive = await client.extensions.download(extensionId);
await writeFile("extension.zip", Buffer.from(await archive.arrayBuffer()));
```

**Python**

```python
archive = client.extensions.download(extension_id)
archive.write_to_file("extension.zip")
```

**Go**

```go
import (
	"io"
	"os"
)

archive, err := client.Extensions.Download(ctx, extensionID)
if err != nil {
	return err
}
defer archive.Body.Close()
body, err := io.ReadAll(archive.Body)
if err != nil {
	return err
}
if err := os.WriteFile("extension.zip", body, 0o644); err != nil {
	return err
}
```

**Rust**

```rust
let archive = client.extensions().download(&extension_id).await?;
std::fs::write("extension.zip", archive)?;
```

See [Extensions](https://steel.dev/docs/sessions/extensions).

### Update an extension

```http
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`.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `extensionId` | path | string | yes | | The ID of the extension. |
| `file` | body | file | no | | The new extension, as a `.zip` or `.crx` file. |
| `url` | body | string (uri) | no | | The Chrome Web Store URL of the extension. |

The response has the fields in [Upload an extension](https://steel.dev/docs/reference/api/extensions#upload-an-extension).

**cURL**

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

**TypeScript**

```ts
import { createReadStream } from "node:fs";

const extension = await client.extensions.update(extensionId, {
  file: createReadStream("extension.zip"),
});
console.log(extension.updatedAt);
```

**Python**

```python
from pathlib import Path

extension = client.extensions.update(extension_id, file=Path("extension.zip"))
print(extension.updated_at)
```

**Go**

```go
import (
	"io"
	"os"
)

file, err := os.Open("extension.zip")
if err != nil {
	return err
}
defer file.Close()

extension, err := client.Extensions.Update(ctx, extensionID, steel.ExtensionUpdateParams{
	File: steel.F[io.Reader](file),
})
if err != nil {
	return err
}
fmt.Println(extension.UpdatedAt)
```

**Rust**

```rust
let file = steel_rs::Upload::open("extension.zip").await?;
let extension = client
    .extensions()
    .update(
        &extension_id,
        steel_rs::ExtensionUpdateParams {
            file: Some(file),
            ..Default::default()
        },
    )
    .await?;
println!("{}", extension.updated_at);
```

See [Extensions](https://steel.dev/docs/sessions/extensions).

### Delete an extension

```http
DELETE /v1/extensions/{extensionId}
```

Deletes one extension.

| Name | In | Type | Required | Default | Description |
| - | - | - | - | - | - |
| `extensionId` | path | string | yes | | The ID of the extension. |

| Field | Type | Description |
| - | - | - |
| `message` | string | A message about the result. |

**cURL**

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

**TypeScript**

```ts
await client.extensions.delete(extensionId);
```

**Python**

```python
client.extensions.delete(extension_id)
```

**Go**

```go
if _, err := client.Extensions.Delete(ctx, extensionID); err != nil {
	return err
}
```

**Rust**

```rust
client.extensions().delete(&extension_id).await?;
```

See [Extensions](https://steel.dev/docs/sessions/extensions).

### Delete all extensions

```http
DELETE /v1/extensions
```

Deletes every extension of your organization.

This endpoint takes no parameters.

| Field | Type | Description |
| - | - | - |
| `message` | string | A message about the result. |

**cURL**

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

**TypeScript**

```ts
const result = await client.extensions.deleteAll();
console.log(result.message);
```

**Python**

```python
result = client.extensions.delete_all()
print(result.message)
```

**Go**

```go
result, err := client.Extensions.DeleteAll(ctx)
if err != nil {
	return err
}
fmt.Println(result.Message)
```

**Rust**

```rust
let result = client.extensions().delete_all().await?;
println!("{}", result.message);
```

See [Extensions](https://steel.dev/docs/sessions/extensions).
