Store Items

Inspect items within an instance store.

Store Items object

Attributes

object

String

String representing the object's type

id

String

kind

Enum

path

String

store_id

String

directory_id

StringNullable

file

ObjectNullable

document

ObjectNullable

created_at

Date

updated_at

Date
{
  "object": "store.item",
  "kind": "file",
  "file": {
    "object": "file",
    "id": "fil_9jKlMnPqRsTuVwXy",
    "status": "active",
    "file_name": "company-logo.png",
    "file_size": 245760,
    "file_type": "image/png",
    "title": "Company Logo",
    "purpose": "organization_logo",
    "created_by": {
      "type": "organization_actor",
      "organization_actor": {
        "object": "organization.actor",
        "id": "omem_5fGhJkLmNpQrStUv",
        "type": "member",
        "organization_id": "org_7hNkPqRsTuVwXyZa",
        "name": "Alex Chen",
        "email": "[email protected]",
        "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
        "teams": [
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          },
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          }
        ]
      },
      "consumer": {
        "object": "consumer"
      }
    }
  },
  "document": {
    "object": "document",
    "status": "active",
    "created_by": {
      "type": "organization_actor",
      "organization_actor": {
        "object": "organization.actor",
        "id": "omem_5fGhJkLmNpQrStUv",
        "type": "member",
        "organization_id": "org_7hNkPqRsTuVwXyZa",
        "name": "Alex Chen",
        "email": "[email protected]",
        "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
        "teams": [
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          },
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          }
        ]
      },
      "consumer": {
        "object": "consumer"
      }
    }
  }
}

List store items

Returns a paginated list of items for a specific store.

URL Parameters

store_id

String

The unique identifier for the store

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

Filter by store item ID

file_id

UnionOptional

Filter by file ID

document_id

UnionOptional

Filter by document ID

type

UnionOptional

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

created_at

ObjectOptional

Filter Filter by creation time by date range

updated_at

ObjectOptional

Filter Filter by update time by date range

GEThttp://api.metorial.com/stores/:store_id/items
curl -X GET "https://api.metorial.com/stores/sto_Rm4Mnheq2bfEPhBhP7SY/items" \
  -H "Authorization: Bearer metorial_sk_..."

Get store item by ID

Retrieves a specific item within a store.

URL Parameters

store_id

String

The unique identifier for the store

item_id

String

The unique identifier for the item

GEThttp://api.metorial.com/stores/:store_id/items/:item_id
curl -X GET "https://api.metorial.com/stores/sto_Rm4Mnheq2bfEPhBhP7SY/items/ite_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."