BlocktionBlocktion Docs
Platform•GitHub

Documentation

Getting Started
Parameters & Configuration
Authentication
Workflows
Blocks
Handlers
Sessions
Providers
DataStores
Triggers
Marketplace

Marketplace

Discover, install, and share blocks, workflows, and providers with the community

Marketplace Features

Discovery

Browse and search for available resources

Installation

Install blocks and workflows into your workspace

Publishing

Share your own creations with the community

Rating & Reviews

Rate and review marketplace items

Collections

Organized groups of related resources

Analytics

Track usage and performance of your published items

Marketplace Items

Blocks

Individual workflow building blocks

Examples:

Email SenderData ProcessorAPI Connector

Workflows

Complete workflow templates

Examples:

E-commerce AutomationData PipelineNotification System

Providers

Integration providers for external services

Examples:

Slack ProviderStripe ProviderAWS Provider

Collections

Curated groups of related items

Examples:

Marketing ToolsDevOps SuiteAnalytics Pack

Overview

The Marketplace enables discovery, installation, and sharing of blocks, workflows, and providers within the Blocktion ecosystem.

Marketplace Features

  • • Browse and discover items
  • • Install and manage items
  • • Rate and review system
  • • Collections and categorization

Item Types

  • • Blocks - Reusable components
  • • Workflows - Complete processes
  • • Providers - Service integrations
  • • Collections - Curated groups

Endpoints

GET/api/marketplace/items

Browse Items

Search and discover marketplace items

Query Parameters

query(string)Search query
item_type(string)Filter by item type
collection_id(string)Filter by collection ID
featured_only(boolean)Only featured
verified_only(boolean)Only verified
user_owned(boolean)Only your items
skip(number)Records to skip
limit(number)Max records (1-100)

Response

{
  "data": [
    {
      "marketplace_item_id": "item_123456",
      "item_type": "block",
      "entity_id": "block_789012",
      "name": "Send Email Block",
      "description": "A powerful block for sending emails via SMTP",
      "tags": [
        "communication",
        "email",
        "smtp"
      ],
      "author_id": "user_456789",
      "author_name": "John Doe",
      "entity_data": {},
      "stats": {},
      "featured": true,
      "verified": true,
      "version": "1.2.0",
      "published_at": "2024-01-15T10:30:00Z",
      "last_updated": "2024-01-20T14:22:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/unpublished

List Unpublished

List your unpublished entities

Query Parameters

query(string)Search query
item_type(string)Filter by item type
skip(number)Records to skip
limit(number)Max records (1-100)

Response

{
  "data": [
    {
      "entity_id": "block_789012",
      "name": "My Block",
      "description": "Draft block",
      "item_type": "block"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/unpublished" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/items/featured

Featured Items

Get featured marketplace items

Query Parameters

skip(number)Records to skip
limit(number)Max records (1-50)

Response

{
  "data": []
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items/featured" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/items/popular

Popular Items

Get popular marketplace items

Query Parameters

skip(number)Records to skip
limit(number)Max records (1-50)
days_range(number)Days range (1-365)

Response

{
  "data": []
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items/popular" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/items/tags

Tags with Counts

Get marketplace tags with item counts

Response

{
  "data": {
    "communication": 12
  }
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items/tags" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/items/{item_id}

Get Item

Get marketplace item by ID

Response

{
  "data": {
    "marketplace_item_id": "item_123456",
    "item_type": "block",
    "entity_id": "block_789012",
    "name": "Send Email Block"
  }
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items/{item_id}" \
+  -H "Authorization: Bearer <your_access_token>"
POST/api/marketplace/items/{item_id}/install

Install Item

Install a marketplace item

Request Body

{
  "auto_update": "boolean (optional, default: true)"
}

Response

{
  "data": {
    "installation_id": "inst_123",
    "status": "installed"
  },
  "message": "Item installed successfully"
}

cURL Example

curl -X POST "https://api.blocktion.io/api/marketplace/items/{item_id}/install" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
  "auto_update": "boolean (optional, default: true)"
}'
GET/api/marketplace/installations

List Installations

List your installed items

Query Parameters

skip(number)Records to skip
limit(number)Max records (1-100)

Response

{
  "data": [],
  "total": 0,
  "page": 1,
  "limit": 50
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/installations" \
+  -H "Authorization: Bearer <your_access_token>"
DELETE/api/marketplace/items/{item_id}/uninstall

Uninstall Item

Uninstall a marketplace item

Response

{
  "data": {
    "marketplace_item_id": "item_123456",
    "uninstalled": true,
    "message": "Item uninstalled successfully"
  }
}

cURL Example

curl -X DELETE "https://api.blocktion.io/api/marketplace/items/{item_id}/uninstall" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>"
POST/api/marketplace/items/{item_id}/rate

Rate Item

Rate a marketplace item

Request Body

{
  "rating": "number (required, 1-5)",
  "review_text": "string (optional, up to 2000 chars)"
}

Response

{
  "data": {
    "rating": 5,
    "review_text": "Great!",
    "helpful_votes": 0,
    "is_verified": false,
    "created_at": "2024-01-15T10:30:00Z",
    "is_detailed": false
  },
  "message": "Rating submitted successfully"
}

cURL Example

curl -X POST "https://api.blocktion.io/api/marketplace/items/{item_id}/rate" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
  "rating": "number (required, 1-5)",
  "review_text": "string (optional, up to 2000 chars)"
}'
GET/api/marketplace/items/{item_id}/ratings

Get Item Ratings

Get ratings for an item

Query Parameters

skip(number)Records to skip
limit(number)Max records (1-100)

Response

{
  "data": [],
  "total": 0,
  "page": 1,
  "limit": 50
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/items/{item_id}/ratings" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/stats

Marketplace Stats

Get marketplace statistics

Response

{
  "data": {}
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/stats" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/creator/{creator_id}/usage-stats

Creator Usage Stats

Get usage statistics for a creator

Query Parameters

start_date(string)Start date (ISO)
end_date(string)End date (ISO)

Response

{
  "data": {},
  "message": "Usage statistics retrieved successfully"
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/creator/{creator_id}/usage-stats" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/creator/{creator_id}/revenue

Creator Revenue

Calculate revenue for a creator

Query Parameters

start_date(string)Start date (ISO)
end_date(string)End date (ISO)
rate_per_use(number)Revenue per use (default $0.01)

Response

{
  "data": {},
  "message": "Revenue calculation completed successfully"
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/creator/{creator_id}/revenue" \
+  -H "Authorization: Bearer <your_access_token>"
POST/api/marketplace/track-usage

Track Item Usage

Manually track usage of a marketplace item

Request Body

{
  "marketplace_item_id": "string (required)",
  "usage_context": "object (optional)"
}

Response

{
  "data": {
    "success": true
  },
  "message": "Usage tracked successfully"
}

cURL Example

curl -X POST "https://api.blocktion.io/api/marketplace/track-usage" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
  "marketplace_item_id": "string (required)",
  "usage_context": "object (optional)"
}'
POST/api/marketplace/track-workflow-usage

Track Workflow Usage

Track usage for items used in a workflow execution

Request Body

{
  "workflow_id": "string (required)",
  "session_id": "string (required)",
  "executed_items": "string[] (required)"
}

Response

{
  "data": {
    "results": {},
    "total_items": 0,
    "successful_tracking": 0
  },
  "message": "Workflow usage tracking completed"
}

cURL Example

curl -X POST "https://api.blocktion.io/api/marketplace/track-workflow-usage" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
  "workflow_id": "string (required)",
  "session_id": "string (required)",
  "executed_items": "string[] (required)"
}'
PUT/api/marketplace/items/{item_id}

Update Item

Update a marketplace item's metadata

Request Body

{
  "name": "string (optional)",
  "description": "string (optional)",
  "tags": "string[] (optional)",
  "category": "string (optional)"
}

Response

{
  "data": {
    "marketplace_item_id": "item_123456",
    "name": "New Name"
  }
}

cURL Example

curl -X PUT "https://api.blocktion.io/api/marketplace/items/{item_id}" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>" \
+  -d '{
  "name": "string (optional)",
  "description": "string (optional)",
  "tags": "string[] (optional)",
  "category": "string (optional)"
}'
DELETE/api/marketplace/items/{item_id}

Delete Item

Delete a marketplace item

Response

{
  "data": {
    "message": "Marketplace item deleted successfully"
  }
}

cURL Example

curl -X DELETE "https://api.blocktion.io/api/marketplace/items/{item_id}" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer <your_access_token>"
GET/api/marketplace/collections

List Collections

List marketplace collections

Query Parameters

skip(number)Records to skip
limit(number)Max records (1-100)
creator_id(string)Filter by creator
featured_only(boolean)Only featured
category(string)Filter by category
visibility(string)Filter by visibility

Response

{
  "data": [],
  "total": 0,
  "page": 1,
  "limit": 50
}

cURL Example

curl -X GET "https://api.blocktion.io/api/marketplace/collections" \
+  -H "Authorization: Bearer <your_access_token>"

Best Practices

Guidelines for using the marketplace effectively

Publishing Items

  • • Provide clear, descriptive names and descriptions
  • • Use relevant tags to improve discoverability
  • • Include comprehensive documentation
  • • Test your items thoroughly before publishing
  • • Keep items updated with bug fixes and improvements

Search and Discovery

  • • Use specific, relevant search terms
  • • Filter by item type, featured status, and verification
  • • Check ratings and reviews before installing
  • • Verify compatibility with your workspace
  • • Report issues or bugs to the author