Skip to content

Get Object Metadata

GET
/api/v1/storage/objects/{key}/metadata

Get metadata for a storage object.

Args: key: Full object key (path) storage: Storage provider (injected)

Returns: ObjectMetadataResponse with full metadata

Raises: HTTPException: 404 if not found, 503 if storage not available

key
required
Key
string

Successful Response

ObjectMetadataResponse

Full object metadata response.

object
key
required
Key

Full object key

string
content_type
required
Content Type

MIME type

string
content_length
required
Content Length

Size in bytes

integer
checksum
Any of:
string
created_at
Any of:
string format: date-time
modified_at
Any of:
string format: date-time
correlation_id
Any of:
string
route_id
Any of:
string
stage
Any of:
string
document_id
Any of:
string
title
Any of:
string
url
Any of:
string
original_object_key
Any of:
string

Resource not found

ErrorResponse

Standard error response matching FastAPI HTTPException format.

This model is used in OpenAPI response declarations for 4xx/5xx errors. The detail field matches FastAPI’s HTTPException structure.

object
detail
required
Detail

Error message (matches FastAPI HTTPException)

string
error_code
Any of:
string
correlation_id
Any of:
string
timestamp
Timestamp

Error timestamp

string format: date-time

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object