---
title: "Obj Read"
method: POST
path: "/obj/read"
tags: ["Objects"]
---

# Obj Read

`POST /obj/read`

## Request

- Base URL: `https://trace.wandb.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://trace.wandb.ai/obj/read`
- Auth: none declared

## Request body

- ObjReadReq
  - `project_id` string, required
  - `object_id` string, required
  - `digest` string, required
  - `metadata_only` boolean, nullable: If true, the `val` column is not read from the database and is empty.All other fields are returned.
  - `include_tags_and_aliases` boolean, nullable: If true, tags and aliases are fetched and included in the response.

## Response `200`

Successful Response

- ObjReadRes
  - `obj` ObjSchema, required
    - `project_id` string, required
    - `object_id` string, required
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time, nullable
    - `digest` string, required
    - `version_index` integer, required
    - `is_latest` integer, required
    - `kind` string, required
    - `base_object_class` string, nullable, required
    - `leaf_object_class` string, nullable
    - `val` unknown, required
    - `wb_user_id` string, nullable: Do not set directly. Server will automatically populate this field.
    - `size_bytes` integer, nullable
    - `tags` string[], nullable
    - `aliases` string[], nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `dd89fadfe4e4`: 6 info
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the new optional request property `include_tags_and_aliases`
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - …2 more

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/obj/read/post.md)

---

[API](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api.md) - [All operations](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/revisions/f7643c49bf2e?raw)