Get an extension
Get an extension.
GET
/v1/extensions/{id}Request
| Method and path | GET/v1/extensions/{id} |
|---|---|
| Base URL | https://api.boxline.dev |
| Authentication | Your API key in the x-api-key header (or Authorization: Bearer). The examples read it from BOXLINE_API_KEY. |
Path parameters
| Name | Type | Default | Allowed values | Description |
|---|---|---|---|---|
idrequired | string | – | – |
curl "https://api.boxline.dev/v1/extensions/$EXTENSION_ID" \ -H "x-api-key: $BOXLINE_API_KEY"import { Boxline } from "@boxline/sdk";const bx = new Boxline(); // reads BOXLINE_API_KEY and BOXLINE_API_URLconst ext = await bx.extensions.get("EXTENSION_ID");console.log(ext.name, ext.permissions, ext.hostPermissions, ext.sha256);from boxline import Boxlinebx = Boxline() # reads BOXLINE_API_KEY and BOXLINE_API_URLext = bx.extensions.get("EXTENSION_ID")print(ext["name"], ext["permissions"], ext["hostPermissions"], ext["sha256"])Responses
200 OK
The extension.
Fields
| Name | Type | Default | Allowed values | Description |
|---|---|---|---|---|
id | string | – | – | |
name | string | – | – | From the manifest (resolved from _locales when it uses __MSG_…__). |
version | string | – | – | |
description | string | – | – | |
permissions | string[] | – | – | |
hostPermissions | string[] | – | – | |
sizeBytes | integer | – | – | Size of the zip. |
files | integer | – | – | |
sha256 | string | – | – | Of the zip. |
createdAt | string | – | – | Format: date-time. |
{ "id": "ext_Q2x9L0aPz7NmK3Jb", "name": "Work account", "version": "1.2.0", "description": "…", "permissions": [ "…" ], "hostPermissions": [ "…" ], "sizeBytes": 0, "files": 0, "sha256": "…", "createdAt": "2026-09-29T10:00:00.000Z"}Errors
Errors have a matching HTTP status and the same body. code is stable, so check it in your code; message is for people. See Errors and request ids.
| Status | Codes | When |
|---|---|---|
| 401 Unauthorized | unauthorized | Missing or invalid API key. |
| 404 Not Found | not_found, invite_not_found, provider_unavailable | No such thing in this project (or organization), or no such route. |
{ "error": { "code": "not_found", "message": "session not found", "requestId": "req_4fJx0aQm2Lk9Pz7N" }}Learn more
These docs describe a beta API. Endpoints, fields and SDK methods may change before general availability; breaking changes will be listed in the changelog.