---
title: "Story: Upload a File To Existing Story"
method: POST
path: "/{id}/file"
tags: ["Story"]
---

# Story: Upload a File To Existing Story

`POST /{id}/file`

Upload a file to an existing story

## Path parameters

- `id` string, uuid, required

## Query parameters

- `replace_existing` boolean
- `obsolete_id` string, uuid
- `include_outline` boolean

## Response `200`

Success responses with story object

- Story — Model for story objects
  - `created_at` string, date-time
  - `created_by` string, uuid
  - `id` string, uuid
  - `updated_at` string, date-time
  - `updated_by` string, uuid
  - `collaborators` StoryCollaborator[]
    - `created_at` string, date-time
    - `created_by` string, uuid
    - `id` string, uuid
    - `updated_at` string, date-time
    - `updated_by` string, uuid
    - `active` boolean, nullable
    - `email` string
    - `lead_id` integer, nullable
    - `name` string
    - `permission_type` PermissionType — A permission type that can be applied to story collaborator
      - `created_at` string, date-time
      - `created_by` string, uuid
      - `id` string, uuid
      - `updated_at` string, date-time
      - `updated_by` string, uuid
      - `can_add_collaborators` boolean
      - `can_delete` boolean
      - `can_edit` boolean
      - `can_view` boolean
      - `name` string
    - `permission_type_id` string, uuid
    - `story_id` string, uuid
    - `user_id` string, uuid
  - `is_public` boolean
  - `ooxml_documents` OoxmlDocument[]
    - `created_at` string, date-time
    - `created_by` string, uuid
    - `id` string, uuid
    - `updated_at` string, date-time
    - `updated_by` string, uuid
    - `delete_target_on_story_delete` boolean
    - `ooxml_automation_id` string, uuid
    - `story_id` string, uuid
  - `outline` string, nullable
  - `outline_history` StoryOutlineHistory[]
    - `created_at` string, date-time
    - `created_by` string, uuid
    - `id` string, uuid
    - `updated_at` string, date-time
    - `updated_by` string, uuid
    - `collaborator_user_id` string, uuid
    - `outline` string
    - `revision_number` integer
    - `story_id` string, uuid
  - `revision` integer
  - `title` string

## Other responses

- `415` — Unsupported Media Type
- `422` — Unprocessable Entity

---

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