Extension

Method	Path	Description
GET	`/api/v1/extensions/{workspace}/{id}`	Get extension
PUT	`/api/v1/extensions/{workspace}/{id}`	Update extension
DELETE	`/api/v1/extensions/{workspace}/{id}`	Delete extension
GET	`/api/v1/extensions/{workspace}`	List extensions
POST	`/api/v1/extensions/{workspace}`	Create extension

Get extension

GET /api/v1/extensions/{workspace}/{id}

Get a single extension by ID with content

Path Parameters

Name	Required	Description
`workspace`	Yes	Workspace slug
`id`	Yes	Extension ID

Responses

Status	Description
`200`	Extension retrieved successfully
`403`	Not authorized - admin required
`404`	Extension not found

Response Shape

Field	Type	Description
`id`	`string (uuid)`	Extension ID
`label`	`string`	Label for the extension
`targetMatrixUri`	`string`	Target matrix URI being extended
`active`	`boolean`	Whether extension has been deployed
`ownerId`	`string (uuid)`	Owner user ID
`ownerUsername`	`string`	Owner username
`content`	`string`	Turtle content (only included in single extension GET)
`createdAt`	`string (date-time)`	Creation timestamp
`updatedAt`	`string (date-time)`	Last update timestamp

Example Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "string",
    "targetMatrixUri": "string",
    "active": true,
    "ownerId": "550e8400-e29b-41d4-a716-446655440000",
    "ownerUsername": "string",
    "content": "string",
    "createdAt": "2025-03-28T14:22:03Z",
    "updatedAt": "2025-03-28T14:22:03Z"
  }
}

Example

curl -X GET "https://poliglot.io/api/v1/extensions/my-workspace/<id>" \
  -H "Authorization: Bearer <your-token>"

Update extension

PUT /api/v1/extensions/{workspace}/{id}

Update an extension's label or content. Triggers partial re-deployment.

Path Parameters

Name	Required	Description
`workspace`	Yes	Workspace slug
`id`	Yes	Extension ID

Query Parameters

Name	Required	Type	Description
`label`	No	`string`	Optional new label

Request Body

Content-Type: multipart/form-data

Field	Type	Description
`file`	`string (binary)`	Optional new Turtle content file

Responses

Status	Description
`200`	Extension updated successfully
`400`	Invalid request or Turtle syntax
`403`	Not authorized - admin required
`404`	Extension not found

Response Shape

Field	Type	Description
`id`	`string (uuid)`	Extension ID
`label`	`string`	Label for the extension
`targetMatrixUri`	`string`	Target matrix URI being extended
`active`	`boolean`	Whether extension has been deployed
`ownerId`	`string (uuid)`	Owner user ID
`ownerUsername`	`string`	Owner username
`content`	`string`	Turtle content (only included in single extension GET)
`createdAt`	`string (date-time)`	Creation timestamp
`updatedAt`	`string (date-time)`	Last update timestamp

Example Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "string",
    "targetMatrixUri": "string",
    "active": true,
    "ownerId": "550e8400-e29b-41d4-a716-446655440000",
    "ownerUsername": "string",
    "content": "string",
    "createdAt": "2025-03-28T14:22:03Z",
    "updatedAt": "2025-03-28T14:22:03Z"
  }
}

Example

curl -X PUT "https://poliglot.io/api/v1/extensions/my-workspace/<id>" \
  -H "Authorization: Bearer <your-token>"
  -H "Content-Type: application/json" \
  -d '{}'

Delete extension

DELETE /api/v1/extensions/{workspace}/{id}

Delete an extension. Triggers partial re-deployment.

Path Parameters

Name	Required	Description
`workspace`	Yes	Workspace slug
`id`	Yes	Extension ID

Responses

Status	Description
`200`	Extension deleted successfully
`403`	Not authorized - admin required
`404`	Extension not found

Example Response

{
  "success": true,
  "data": "string"
}

Example

curl -X DELETE "https://poliglot.io/api/v1/extensions/my-workspace/<id>" \
  -H "Authorization: Bearer <your-token>"

List extensions

GET /api/v1/extensions/{workspace}

List all extensions in a workspace

Path Parameters

Name	Required	Description
`workspace`	Yes	Workspace slug

Responses

Status	Description
`200`	Extensions retrieved successfully
`403`	Not authorized - admin required
`404`	Workspace not found

Example Response

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "label": "string",
      "targetMatrixUri": "string",
      "active": true,
      "ownerId": "550e8400-e29b-41d4-a716-446655440000",
      "ownerUsername": "string",
      "content": "string",
      "createdAt": "2025-03-28T14:22:03Z",
      "updatedAt": "2025-03-28T14:22:03Z"
    }
  ]
}

Example

curl -X GET "https://poliglot.io/api/v1/extensions/my-workspace" \
  -H "Authorization: Bearer <your-token>"

Create extension

POST /api/v1/extensions/{workspace}

Create a new matrix extension. Triggers partial re-deployment of the target matrix.

Path Parameters

Name	Required	Description
`workspace`	Yes	Workspace slug

Query Parameters

Name	Required	Type	Description
`targetMatrix`	Yes	`string`	Target matrix URI
`label`	No	`string`	Optional label

Request Body

Content-Type: multipart/form-data

Field	Type	Description
`file`	`string (binary)`	Turtle content file

Responses

Status	Description
`200`	Extension created successfully
`400`	Invalid request or Turtle syntax
`403`	Not authorized - admin required
`404`	Workspace or target matrix not found

Response Shape

Field	Type	Description
`id`	`string (uuid)`	Extension ID
`label`	`string`	Label for the extension
`targetMatrixUri`	`string`	Target matrix URI being extended
`active`	`boolean`	Whether extension has been deployed
`ownerId`	`string (uuid)`	Owner user ID
`ownerUsername`	`string`	Owner username
`content`	`string`	Turtle content (only included in single extension GET)
`createdAt`	`string (date-time)`	Creation timestamp
`updatedAt`	`string (date-time)`	Last update timestamp

Example Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "label": "string",
    "targetMatrixUri": "string",
    "active": true,
    "ownerId": "550e8400-e29b-41d4-a716-446655440000",
    "ownerUsername": "string",
    "content": "string",
    "createdAt": "2025-03-28T14:22:03Z",
    "updatedAt": "2025-03-28T14:22:03Z"
  }
}

Example

curl -X POST "https://poliglot.io/api/v1/extensions/my-workspace" \
  -H "Authorization: Bearer <your-token>"
  -H "Content-Type: application/json" \
  -d '{}'

On this page