---
title: "Search for tetrasphere artifacts"
method: POST
path: "/v1/artifacts/tetraspheres/search"
tags: ["tetraspheres"]
---

# Search for tetrasphere artifacts

`POST /v1/artifacts/tetraspheres/search`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/artifacts/tetraspheres/search`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

Search for items using specified criteria

## Query parameters

- `value` string, required
- `limit` integer
- `include_prereleases` boolean

## Response `200`

A list of items that match the search query

- TetrasphereObject[]
  - `namespace` string, required
  - `slug` string, required
  - `version` string, required
  - `name` string, nullable
  - `description` string, nullable
  - `createdAt` string, date-time, required
  - `lastUpdatedAt` string, date-time, required
  - `otherVersions` string[]
  - `supportedPlatformVersion` SupportedPlatformVersion, nullable
    - `minPlatformVersion` string
    - `maxPlatformVersion` string, nullable
  - `type` 'tetrasphere', required

## Other responses

- `404`: Not found or not visible to user

---

[API](https://skmtc.dev/tetrascience/apis/artifact-management-service.md) - [All operations](https://skmtc.dev/tetrascience/apis/artifact-management-service/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/artifact-management-service/revisions/b96707d992f5?raw)