---
title: "Update status of a submission"
method: PUT
path: "/v4/submissions/{submissionId}/status"
tags: ["Submissions"]
---

# Update status of a submission

`PUT /v4/submissions/{submissionId}/status`

## Path parameters

- `submissionId` string, uuid, required

## Request body

- union
  - UpdateSubmissionStatusAcceptedRequest
    - `status` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', required
    - `internalNote` string, nullable
    - `message` CreateSubmissionMessageRequest
      - `subject` string, required
      - `body` string, required
      - `files` FileRequest[], nullable
        - `fileId` string, required
      - `shouldUseOrganizationEmailAsFromAddress` boolean
  - UpdateSubmissionStatusInProgressRequest
    - `status` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', required
    - `internalNote` string, nullable
    - `message` CreateSubmissionMessageRequest
      - `subject` string, required
      - `body` string, required
      - `files` FileRequest[], nullable
        - `fileId` string, required
      - `shouldUseOrganizationEmailAsFromAddress` boolean
  - UpdateSubmissionStatusDeclinedRequest
    - `status` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', required
    - `internalNote` string, nullable
    - `message` CreateSubmissionMessageRequest
      - `subject` string, required
      - `body` string, required
      - `files` FileRequest[], nullable
        - `fileId` string, required
      - `shouldUseOrganizationEmailAsFromAddress` boolean
  - UpdateSubmissionStatusWithdrawnRequest
    - `status` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', required
    - `internalNote` string, nullable
    - `message` CreateSubmissionMessageRequest
      - `subject` string, required
      - `body` string, required
      - `files` FileRequest[], nullable
        - `fileId` string, required
      - `shouldUseOrganizationEmailAsFromAddress` boolean
  - UpdateSubmissionStatusCompletedRequest
    - `status` 'new' | 'in_progress' | 'accepted' | 'declined' | 'withdrawn' | 'completed' | 'editable' | 'viewed' | 'received' | 'published', required
    - `internalNote` string, nullable
    - `message` CreateSubmissionMessageRequest
      - `subject` string, required
      - `body` string, required
      - `files` FileRequest[], nullable
        - `fileId` string, required
      - `shouldUseOrganizationEmailAsFromAddress` boolean

## Response `204`

Submission status updated

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)