Store Items

List store items

Returns a paginated list of items for a specific store.

get/stores/{store_id}/items

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Path parameters

store_idstring required

Unique identifier of the store.

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
string
OR
string[]

Filter by store item ID

string
OR
string[]

Filter by file ID

string
OR
string[]

Filter by document ID

'file' | 'document' | 'directory'
OR
string[]

Filter by store item type. Repeat type to include multiple values. Defaults to file and document.

gtstring date-time

Only include records after this timestamp for Filter by creation time

ltstring date-time

Only include records before this timestamp for Filter by creation time

Filter Filter by creation time by date range

gtstring date-time

Only include records after this timestamp for Filter by update time

ltstring date-time

Only include records before this timestamp for Filter by update time

Filter Filter by update time by date range

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

Example response

{
  "items": [
    {
      "file": {
        "id": "fil_9jKlMnPqRsTuVwXy",
        "file_name": "company-logo.png",
        "file_size": 245760,
        "file_type": "image/png",
        "title": "Company Logo",
        "purpose": "organization_logo",
        "created_by": {
          "organization_actor": {
            "id": "omem_5fGhJkLmNpQrStUv",
            "organization_id": "org_7hNkPqRsTuVwXyZa",
            "name": "Alex Chen",
            "email": "alex.chen@acme.com",
            "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
            "member": {
              "id": "ome_7hNkPqRsTuVwXyZa"
            },
            "teams": [
              {
                "id": "tm_3eFgHjKlMnPqRsTu",
                "name": "Engineering",
                "slug": "engineering",
                "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
              }
            ]
          }
        }
      },
      "document": {
        "created_by": {
          "organization_actor": {
            "id": "omem_5fGhJkLmNpQrStUv",
            "organization_id": "org_7hNkPqRsTuVwXyZa",
            "name": "Alex Chen",
            "email": "alex.chen@acme.com",
            "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
            "member": {
              "id": "ome_7hNkPqRsTuVwXyZa"
            },
            "teams": [
              {
                "id": "tm_3eFgHjKlMnPqRsTu",
                "name": "Engineering",
                "slug": "engineering",
                "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
              }
            ]
          }
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.