# Upload payload files

`POST /workspaces/:workspace/projects/:project_name/pipelines/:pipeline_id/payload-files`

Uploads one or more files to temporary storage and returns their identifiers; pass the identifiers together with target paths in the run request to place the files in the pipeline filesystem before execution

**Required Scopes:** `EXECUTION_RUN`

## URL Parameters

```typescript
interface URLParameters {
  /** The human-readable ID of the workspace */
  workspace: string; // Example: "my-company"
  /** The human-readable ID of the project */
  project_name: string; // Example: "my-project"
  /** The ID of the pipeline */
  pipeline_id: number; // Example: 123
}
```

## Response Body

```typescript
interface ResponseBody {
  /** API endpoint to GET this object */
  url?: string;
  /** Web URL to view this object in Buddy.works */
  html_url?: string;
  /** The list of uploaded files */
  payload_files?: PayloadFileView[];
}
```

## Type Definitions

```typescript
interface PayloadFileView {
  /** The identifier of the uploaded file returned by the upload endpoint */
  uuid?: string;
  /** The original name of the uploaded file */
  name?: string;
  /** The target path in the pipeline filesystem where the file is placed; when empty the file is placed in the filesystem root under its original name */
  path?: string;
}

```

## Response Example

**Status:** `200 OK`


---
Original source: https://buddy.works/docs/api/executions/upload-payload-files