Sign in

v5

latestOpenAPI 3.1.02026-08-04166362486.5 KB
stores

Get a store

Get a store by ID or name.

Args: store_identifier: The ID or name of the store to retrieve.

Returns: Store: The response containing the store details.

get/v1/stores/{store_identifier}

Path parameters

string required
OR
string uuid required

The ID or name of the store

Response

The details of the store

idstring required

Unique identifier for the store

namestring required

Name of the store

descriptionstring nullable

Detailed description of the store's purpose and contents

is_publicboolean

Whether the store can be accessed by anyone with valid login credentials

licensestring nullable

License for public stores

{"stackTrail":"components:schemas:Store:properties:metadata:anyOf","oasType":"schema","type":"unknown","title":"Metadata","description":"Additional metadata associated with the store","example":{"category":"support","language":"en"},"nullable":true}
bucket_idstring nullable

Customer bucket backing this store's storage; null = platform default

status'expired' | 'in_progress' | 'completed'

Status of a store.

created_atstring date-time required

Timestamp when the store was created

updated_atstring date-time required

Timestamp when the store was last updated

last_active_atstring date-time nullable

Timestamp when the store was last used

usage_bytesinteger

Total storage usage in bytes

usage_tokensinteger

Total storage usage in tokens

expires_atstring date-time nullable

Optional expiration timestamp for the store

object'store'

Type of the object

Example response

{
  "id": "1b8b486e-16d0-400b-8868-04cd75217a7e",
  "name": "customer-support-kb",
  "description": "Contains customer support articles and FAQs",
  "metadata": {
    "category": "support",
    "language": "en"
  },
  "file_counts": {
    "pending": 5,
    "in_progress": 5,
    "cancelled": 2,
    "completed": 42,
    "failed": 1,
    "total": 50
  },
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z",
  "usage_bytes": 1024000,
  "usage_tokens": 1024000,
  "expires_at": "2024-01-01T00:00:00Z"
}