---
title: "Update a submission data request"
method: PUT
path: "/data_requests/{data_request_id}"
tags: ["Data Requests"]
---

# Update a submission data request

`PUT /data_requests/{data_request_id}`

Updates authentication details for a data request. Use this when a user logs in to record
their authentication method, provider, session information, and hashed identifiers. Updates
metadata and tracks authentication state changes for auditing and compliance.

## Path parameters

- `data_request_id` string, required

## Request body

- object
  - `auth_phone_number_hash` string, nullable
  - `auth_provider` string, nullable
  - `auth_second_factor_type` 'none' | 'phone_number' | 'totp' | 'mobile_push' | 'security_key' | 'fingerprint' | '', nullable
  - `auth_session_id_hash` string, nullable
  - `auth_session_started_at` string, nullable
  - `auth_type` 'none' | 'password' | 'oauth' | 'email_link' | 'phone_number' | 'ldap' | 'saml'
  - `auth_user_id_hash` string, nullable
  - `auth_username_hash` string, nullable
  - `email` string, nullable
  - `fields` string[]
  - `metadata` object
  - `name` string, nullable
  - `order` integer

## Response `200`

submission data request updated

- object
  - `status` 'success' | 'error', required
  - `data_request` SubmissionDataRequestShow, required
    - `id` string, nullable, required
    - `email` string, nullable, required
    - `name` string, nullable, required
    - `order` integer, nullable, required
    - `sort_order` integer, required
    - `fields` string[], nullable, required
    - `metadata` object, nullable, required
    - `state` 'pending' | 'completed', required
    - `viewed_at` string, nullable, required
    - `completed_at` string, nullable, required
    - `data` object, nullable, required
    - `auth_type` 'none' | 'password' | 'oauth' | 'email_link' | 'phone_number' | 'ldap' | 'saml', required
    - `auth_second_factor_type` 'none' | 'phone_number' | 'totp' | 'mobile_push' | 'security_key' | 'fingerprint', required
    - `auth_provider` string, nullable, required
    - `auth_session_started_at` string, nullable, required
    - `auth_session_id_hash` string, nullable, required
    - `auth_user_id_hash` string, nullable, required
    - `auth_username_hash` string, nullable, required
    - `auth_phone_number_hash` string, nullable, required
    - `ip_address` string, nullable, required
    - `user_agent` string, nullable, required
    - `submission_id` string, nullable, required
  - `errors` string[]

## Other responses

- `401` — authentication failed
- `404` — submission data request not found
- `422` — invalid request

---

[API](https://skmtc.dev/docspring/apis/docspring-api.md) · [All operations](https://skmtc.dev/docspring/apis/docspring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docspring/docspring-api/revisions/5726657b9432/schema)