## Retrieve

`builds.target_outputs.retrieve(TargetOutputRetrieveParams**kwargs)  -> TargetOutputRetrieveResponse`

**get** `/v0/build_target_outputs`

Retrieve a method to download an output for a given build target.

If the requested type of output is `source`, and the requested output
method is `url`, a download link to a tarball of the source files is
returned. If the requested output method is `git`, a Git remote, ref,
and access token (if necessary) is returned.

Otherwise, the possible types of outputs are specific to the requested
target, and the output method _must_ be `url`. See the documentation for
`type` for more information.

### Parameters

- `build_id: str`

  Build ID

- `target: Literal["node", "typescript", "python", 10 more]`

  SDK language target name

  - `"node"`

  - `"typescript"`

  - `"python"`

  - `"go"`

  - `"java"`

  - `"kotlin"`

  - `"ruby"`

  - `"terraform"`

  - `"cli"`

  - `"php"`

  - `"csharp"`

  - `"sql"`

  - `"openapi"`

- `type: Literal["source", "dist", "wheel", 3 more]`

  - `"source"`

  - `"dist"`

  - `"wheel"`

  - `"openapi-with-transforms"`

  - `"openapi-with-code-samples"`

  - `"openapi-sdk-spec"`

- `output: Optional[Literal["url", "git"]]`

  Output format: url (download URL) or git (temporary access token).

  - `"url"`

  - `"git"`

### Returns

- `TargetOutputRetrieveResponse`

  - `class URL: …`

    - `output: Literal["url"]`

      - `"url"`

    - `target: Target`

      - `"node"`

      - `"typescript"`

      - `"python"`

      - `"go"`

      - `"java"`

      - `"kotlin"`

      - `"ruby"`

      - `"terraform"`

      - `"cli"`

      - `"php"`

      - `"csharp"`

      - `"sql"`

      - `"openapi"`

    - `type: Literal["source", "dist", "wheel", 3 more]`

      - `"source"`

      - `"dist"`

      - `"wheel"`

      - `"openapi-with-transforms"`

      - `"openapi-with-code-samples"`

      - `"openapi-sdk-spec"`

    - `url: str`

      URL for direct download

  - `class Git: …`

    - `token: str`

      Temporary GitHub access token

    - `output: Literal["git"]`

      - `"git"`

    - `ref: str`

      Git reference (commit SHA, branch, or tag)

    - `target: Target`

      - `"node"`

      - `"typescript"`

      - `"python"`

      - `"go"`

      - `"java"`

      - `"kotlin"`

      - `"ruby"`

      - `"terraform"`

      - `"cli"`

      - `"php"`

      - `"csharp"`

      - `"sql"`

      - `"openapi"`

    - `type: Literal["source", "dist", "wheel", 3 more]`

      - `"source"`

      - `"dist"`

      - `"wheel"`

      - `"openapi-with-transforms"`

      - `"openapi-with-code-samples"`

      - `"openapi-sdk-spec"`

    - `url: str`

      URL to git remote

### Example

```python
import os
from stainless_v0 import Stainless

client = Stainless(
    api_key=os.environ.get("STAINLESS_API_KEY"),  # This is the default and can be omitted
)
target_output = client.builds.target_outputs.retrieve(
    build_id="build_id",
    target="node",
    type="source",
)
print(target_output)
```