# Target Outputs

## Download build target output

`$ stl builds:target-outputs retrieve`

**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: string`

  Build ID

- `--target: "node" or "typescript" or "python" or 10 more`

  SDK language target name

- `--type: "source" or "dist" or "wheel" or 4 more`

- `--output: optional "url" or "git"`

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

- `--path: optional string`

  The path of the file to get when used with "type": "file".

### Returns

- `BuildTargetOutputGetResponse: object { output, target, type, 2 more }  or object { token, output, ref, 3 more }`

  - `url: object { output, target, type, 2 more }`

    - `output: "url"`

      - `"url"`

    - `target: "node" or "typescript" or "python" or 10 more`

      - `"node"`

      - `"typescript"`

      - `"python"`

      - `"go"`

      - `"java"`

      - `"kotlin"`

      - `"ruby"`

      - `"terraform"`

      - `"cli"`

      - `"php"`

      - `"csharp"`

      - `"sql"`

      - `"openapi"`

    - `type: "source" or "dist" or "wheel" or 4 more`

      - `"source"`

      - `"dist"`

      - `"wheel"`

      - `"openapi-with-transforms"`

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

      - `"openapi-sdk-spec"`

      - `"file"`

    - `url: string`

      URL for direct download

    - `path: optional string`

      The path of the file, which is only present when using with the type "file" option.

  - `git: object { token, output, ref, 3 more }`

    - `token: string`

      Temporary GitHub access token

    - `output: "git"`

      - `"git"`

    - `ref: string`

      Git reference (commit SHA, branch, or tag)

    - `target: "node" or "typescript" or "python" or 10 more`

      - `"node"`

      - `"typescript"`

      - `"python"`

      - `"go"`

      - `"java"`

      - `"kotlin"`

      - `"ruby"`

      - `"terraform"`

      - `"cli"`

      - `"php"`

      - `"csharp"`

      - `"sql"`

      - `"openapi"`

    - `type: "source" or "dist" or "wheel" or 4 more`

      - `"source"`

      - `"dist"`

      - `"wheel"`

      - `"openapi-with-transforms"`

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

      - `"openapi-sdk-spec"`

      - `"file"`

    - `url: string`

      URL to git remote

### Example

```cli
stl builds:target-outputs retrieve \
  --api-key 'My API Key' \
  --build-id build_id \
  --target node \
  --type source
```

#### Response

```json
{
  "output": "url",
  "target": "node",
  "type": "source",
  "url": "url",
  "path": "path"
}
```