{
  "opencollection": "1.0.0",
  "info": {
    "name": "Sitecore Content Hub REST API",
    "version": "v1"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Entities",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List entities",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.stylelabs.io/api/entities",
            "params": [
              {
                "name": "definition",
                "value": "",
                "type": "query",
                "description": "Filter entities by their entity definition identifier"
              },
              {
                "name": "skip",
                "value": "",
                "type": "query",
                "description": "Number of entities to skip for pagination"
              },
              {
                "name": "take",
                "value": "",
                "type": "query",
                "description": "Maximum number of entities to return"
              },
              {
                "name": "culture",
                "value": "",
                "type": "query",
                "description": "Culture code for multi-lingual property values (e.g., en-US)"
              }
            ]
          },
          "docs": "Retrieves a paginated list of entities from the Content Hub. Supports filtering by entity definition, property values, and relations. The response includes hyperlinks for navigating to related resources."
        },
        {
          "info": {
            "name": "Create an entity",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/entities",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new entity in Content Hub according to the specified entity definition. The entity type is determined by the definition identifier provided in the request body. Properties and relations are set according to the definition schema."
        },
        {
          "info": {
            "name": "Get an entity",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.stylelabs.io/api/entities/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The numeric identifier of the entity"
              },
              {
                "name": "culture",
                "value": "",
                "type": "query",
                "description": "Culture code for localized properties (e.g., en-US)"
              }
            ]
          },
          "docs": "Retrieves a specific entity by its numeric identifier. Returns the entity with all its properties, relations, and hypermedia links. Use the culture parameter to retrieve localized property values."
        },
        {
          "info": {
            "name": "Update an entity",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{tenant}.stylelabs.io/api/entities/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The numeric identifier of the entity"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Performs a full replacement update of an entity. All properties and relations are replaced with the values in the request body. Missing optional properties will be cleared."
        },
        {
          "info": {
            "name": "Delete an entity",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://{tenant}.stylelabs.io/api/entities/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The numeric identifier of the entity"
              }
            ]
          },
          "docs": "Permanently deletes an entity from Content Hub. This operation is irreversible. Assets that are in use or have active relations may require the relations to be removed first."
        },
        {
          "info": {
            "name": "Update entity lifecycle state",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{tenant}.stylelabs.io/api/entities/:id/lifecycle",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The numeric identifier of the entity"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the lifecycle state of an entity such as an asset. Lifecycle state transitions control the publishing workflow of assets within Content Hub (e.g., Draft, Approved, Published)."
        }
      ]
    },
    {
      "info": {
        "name": "Querying",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Query entities",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/entities/query",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Executes a structured query against the Content Hub entity index. Supports filtering by property values, relations, and entity definition using a query expression language. Returns matching entities with pagination."
        }
      ]
    },
    {
      "info": {
        "name": "Search",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Search entities",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/search",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Executes a full-text and structured search query across the Content Hub entity index. Returns matching entities with facet aggregations for interactive filtering. Supports relevance ranking and pagination."
        }
      ]
    },
    {
      "info": {
        "name": "Upload",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Create an upload request",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/upload",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Initiates a new asset upload into Content Hub by creating an upload request. Returns a target URL and upload identifier used for the subsequent binary file upload step."
        }
      ]
    },
    {
      "info": {
        "name": "Jobs",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List jobs",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.stylelabs.io/api/jobs",
            "params": [
              {
                "name": "skip",
                "value": "",
                "type": "query",
                "description": "Number of jobs to skip for pagination"
              },
              {
                "name": "take",
                "value": "",
                "type": "query",
                "description": "Maximum number of jobs to return"
              }
            ]
          },
          "docs": "Retrieves a list of background job targets configured in the Content Hub instance. Jobs handle long-running operations such as asset processing, reporting, and data exports."
        }
      ]
    },
    {
      "info": {
        "name": "Selections",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List selections",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.stylelabs.io/api/selections"
          },
          "docs": "Retrieves all entity selections across selection pools. Selections group entities for bulk operations such as download, export, or editorial actions."
        },
        {
          "info": {
            "name": "Create a selection",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/selections",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new entity selection in a specified selection pool. Selections hold a list of entity identifiers for subsequent bulk operations."
        }
      ]
    },
    {
      "info": {
        "name": "Audit",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List audit log entries",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.stylelabs.io/api/audit",
            "params": [
              {
                "name": "entityId",
                "value": "",
                "type": "query",
                "description": "Filter audit entries by entity identifier"
              },
              {
                "name": "userId",
                "value": "",
                "type": "query",
                "description": "Filter audit entries by the user who made the change"
              },
              {
                "name": "from",
                "value": "",
                "type": "query",
                "description": "Start date for audit entry filtering (ISO 8601)"
              },
              {
                "name": "to",
                "value": "",
                "type": "query",
                "description": "End date for audit entry filtering (ISO 8601)"
              },
              {
                "name": "skip",
                "value": "",
                "type": "query",
                "description": "Number of entries to skip for pagination"
              },
              {
                "name": "take",
                "value": "",
                "type": "query",
                "description": "Maximum number of entries to return"
              }
            ]
          },
          "docs": "Retrieves and queries audit log entries that record all changes made to entities and configuration within the Content Hub instance. Supports filtering by entity, user, date range, and operation type."
        }
      ]
    },
    {
      "info": {
        "name": "Download Orders",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Create a download order",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.stylelabs.io/api/downloadorders",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a download order that packages one or more assets for delivery. Download orders can specify renditions, file formats, and delivery options. The order is processed asynchronously and the download URL is provided upon completion."
        }
      ]
    }
  ],
  "bundled": true
}