Component API
Get all components
| Path | Method | Protected |
|---|---|---|
/v1/components | GET | No |
Gets all components, optionally filtered by component name.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| component-name | string | No | - |
Example Response JSON
[
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}
]Create a new component
| Path | Method | Protected |
|---|---|---|
/v1/components | POST | No |
The request body is encoded as multipart/form-data containing metadata and the WASM binary.
If the component type is not specified, it will be considered as a Durable component.
Request Form: multipart/form-data
Make sure to include
Content-Type: multipart/form-dataHeader
Field name: string undefined
Field componentType: JSON
"Durable"Field component: string binary
Field filesPermissions: JSON
{
"values": [
{
"path": "string",
"permissions": "read-only"
}
]
}Field files: string binary
Example Response JSON
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}Update a component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/upload | PUT | No |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| component_type | #/components/schemas/ComponentType | No | Type of the new version of the component - if not specified, the type of the previous version |
is used.
Request Body: WASM Binary File
Make sure to include
Content-Type: application/octet-streamHeader
Example Response JSON
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}Update a component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/updates | POST | No |
Request Form: multipart/form-data
Make sure to include
Content-Type: multipart/form-dataHeader
Field componentType: JSON
"Durable"Field component: string binary
Field filesPermissions: JSON
{
"values": [
{
"path": "string",
"permissions": "read-only"
}
]
}Field files: string binary
Example Response JSON
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}Download a component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/download | GET | No |
Downloads a specific version of the component's WASM.
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| version | integer | No | - |
Response Body: WASM Binary File
Get the metadata for all component versions
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id} | GET | No |
Each component can have multiple versions. Every time a new WASM is uploaded for a given component id, that creates a new version. This endpoint returns a list of all versions for the component id provided as part of the URL. Each element of the response describes a single version of a component, but does not contain the binary (WASM) itself:
versionedComponentIdassociates a specific version with the component idcomponentNameis the human-readable name of the componentcomponentSizeis the WASM binary's size in bytesmetadatacontains information extracted from the WASM itselfmetadata.exportsis a list of exported functions, including their parameter's and return value's typesmetadata.producersis a list of producer information added by tooling, each consisting of a list of fields associating one or more values to a given key. This contains information about what compilers and other WASM related tools were used to construct the Golem component.
Example Response JSON
[
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}
]Get the version of a given component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/versions/{version} | GET | No |
Gets the version of a component.
Example Response JSON
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}Get the latest version of a given component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/latest | GET | No |
Gets the latest version of a component.
Example Response JSON
{
"versionedComponentId": {
"componentId": "616ccd92-d666-4180-8349-8d125b269fac",
"version": 0
},
"componentName": "string",
"componentSize": 0,
"metadata": {
"exports": [
{
"type": "Function",
"name": "string",
"parameters": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
],
"results": [
{
"name": "string",
"typ": {
"type": "Variant",
"cases": [
{
"name": "string",
"typ": {}
}
]
}
}
]
}
],
"producers": [
{
"fields": [
{
"name": "string",
"values": [
{
"name": "string",
"version": "string"
}
]
}
]
}
],
"memories": [
{
"initial": 0,
"maximum": 0
}
]
},
"createdAt": "2019-08-24T14:15:22Z",
"componentType": "Durable",
"files": [
{
"key": "string",
"path": "string",
"permissions": "read-only"
}
],
"installedPlugins": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]
}Gets the list of plugins installed for the given component version
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/versions/{version}/plugins/installs | GET | No |
Example Response JSON
[
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}
]Installs a new plugin for this component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/latest/plugins/installs | POST | No |
Example Request JSON
{
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}Example Response JSON
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"version": "string",
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}Updates the priority or parameters of a plugin installation
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/versions/latest/plugins/installs/{installation_id} | PUT | No |
Example Request JSON
{
"priority": 0,
"parameters": {
"property1": "string",
"property2": "string"
}
}Example Response JSON
{}Uninstalls a plugin from this component
| Path | Method | Protected |
|---|---|---|
/v1/components/{component_id}/latest/plugins/installs/{installation_id} | DELETE | No |
Example Response JSON
{}Component API Errors
| Status Code | Description | Body |
|---|---|---|
| 400 | {"errors":["string"]} | |
| 401 | {"error":"string"} | |
| 403 | {"error":"string"} | |
| 404 | {"error":"string"} | |
| 409 | {"error":"string"} | |
| 500 | {"error":"string"} |