---
title: "Retrieve By Pointer"
method: GET
path: "/v4/pipelines/by-pointer/{pointer}"
tags: ["Pipelines"]
---

# Retrieve By Pointer

`GET /v4/pipelines/by-pointer/{pointer}`

Retrieve details for a pipeline by pointer name.

Note that the fields this endpoint returns are dependent on the provided
query parameters and will omit any empty fields.
Accepted query parameters are:
- include_pointers: include any pointers that point to this pipeline

## Path parameters

- `pointer` string, required

## Query parameters

- `include_pointers` boolean
- `include_extras` boolean

## Response `200`

Successful Response

- AppSchemasPipelineGetDetailed — Base model for schemas.
  - `public` boolean, required
  - `description` string
  - `website_url` string
  - `repository_url` string
  - `paper_url` string
  - `license_url` string
  - `image_url` string
  - `name` string, required
  - `image` string, required
  - `input_variables` IOVariable[], required
    - `run_io_type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `title` string
    - `description` string
    - `examples` unknown[]
      - unknown
    - `gt` integer
    - `ge` integer
    - `lt` integer
    - `le` integer
    - `multiple_of` integer
    - `allow_inf_nan` boolean
    - `max_digits` integer
    - `decimal_places` integer
    - `min_length` integer
    - `max_length` integer
    - `choices` unknown[]
      - unknown
    - `dict_schema` object[]
    - `default` unknown
    - `optional` boolean
  - `output_variables` IOVariable[], required
    - `run_io_type` 'integer' | 'string' | 'fp' | 'dictionary' | 'boolean' | 'none' | 'array' | 'pkl' | 'file' | 'stream', required — An enumeration.
    - `title` string
    - `description` string
    - `examples` unknown[]
      - unknown
    - `gt` integer
    - `ge` integer
    - `lt` integer
    - `le` integer
    - `multiple_of` integer
    - `allow_inf_nan` boolean
    - `max_digits` integer
    - `decimal_places` integer
    - `min_length` integer
    - `max_length` integer
    - `choices` unknown[]
      - unknown
    - `dict_schema` object[]
    - `default` unknown
    - `optional` boolean
  - `extras` object
  - `id` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `accelerators` Accelerator[]
  - `cluster` PipelineClusterConfig
    - `id` string, required
    - `node_pool` string, required
  - `scaling_config` string
  - `failed_state_info` PipelineContainerState — Base model for schemas.
    - `state` 'not_loaded' | 'loading' | 'loaded' | 'load_failed' | 'startup_failed' | 'failed', required — An enumeration.
    - `message` string
  - `pointers` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mystic/apis/mystic-api.md) · [All operations](https://skmtc.net/mystic/apis/mystic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mystic/mystic-api/versions/60e569344994/schema)