---
title: "Objs Query"
method: POST
path: "/objs/query"
tags: ["Objects"]
---

# Objs Query

`POST /objs/query`

## 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/objs/query`
- Auth: none declared

## Request body

- ObjQueryReq
  - `project_id` string, required: The ID of the project to query
  - `filter` ObjectVersionFilter
    - `base_object_classes` string[], nullable: Filter objects by their base classes
    - `exclude_base_object_classes` string[], nullable: Exclude objects by their base classes
    - `leaf_object_classes` string[], nullable: Filter objects by their leaf classes
    - `object_ids` string[], nullable: Filter objects by their IDs
    - `is_op` boolean, nullable: Filter objects based on whether they are weave.ops or not. `True` will only return ops, `False` will return non-ops, and `None` will return all objects
    - `latest_only` boolean, nullable: If True, return only the latest version of each object. `False` and `None` will return all versions
    - `tags` string[], nullable: Filter object versions that have any of the specified tags
    - `aliases` string[], nullable: Filter objects that have any of the specified aliases
  - `limit` integer, nullable: Maximum number of results to return
  - `offset` integer, nullable: Number of results to skip before returning
  - `sort_by` SortBy[], nullable: Sorting criteria for the query results. Currently only supports 'object_id' and 'created_at'.
    - `field` string, required
    - `direction` 'asc' | 'desc', 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_storage_size` boolean, nullable: If true, the `size_bytes` column is returned.
  - `include_tags_and_aliases` boolean, nullable: If true, tags and aliases are fetched and included in the response.

## Response `200`

Successful Response

- ObjQueryRes
  - `objs` 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`: 8 info
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - added the new optional request property `filter/anyOf[subschema #1: ObjectVersionFilter]/aliases`
  - added the new optional request property `filter/anyOf[subschema #1: ObjectVersionFilter]/tags`
  - added the new optional request property `include_tags_and_aliases`
  - …4 more
- **2025-11-05** `f4a10b6a2e6d`: 1 info
  - added the new optional request property `filter/anyOf[subschema #1: ObjectVersionFilter]/exclude_base_object_classes`

[Operation history](https://skmtc.dev/wandb/apis/weights-biases-weave-stainless-api/changes/objs/query/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)