---
title: "Create Request"
method: POST
path: "/api/request/"
tags: ["Turbinia Requests"]
---

# Create Request

`POST /api/request/`

Create a new Turbinia request.

Args:
  request (Request): FastAPI request object.
  req (turbinia.api.schema.request): JSON object from the HTTP POST data
      matching the schema defined for a Turbinia Request. The schema is used
      by pydantic for field validation.

Raises:
  ValidationError: if the Request object contains invalid data.
  HTTPException: If pre-conditions are not met.

## Request body

- Request — Base request object.
  - `description` string
  - `evidence` object, required
  - `request_options` BaseRequestOptions, required — Base Request Options class to be extended by other option types.
    - `filter_patterns` string[]
    - `group_id` string
    - `jobs_allowlist` string[]
    - `jobs_denylist` string[]
    - `reason` string
    - `recipe_data` string
    - `recipe_name` string
    - `request_id` string
    - `requester` string
    - `sketch_id` integer
    - `yara_rules` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 12 revisions in range; 1 could not be searched.

- **2023-10-05** `29f05144f92c` — 12 breaking
  - request property `description` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `request_options/filter_patterns` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `request_options/group_id` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `request_options/jobs_allowlist` list-of-types was narrowed by removing types `null` from media type `application/json`
  - …8 more
- **2023-09-01** `a7f1f9e6443d` — 12 info
  - request property `description` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `request_options/filter_patterns` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `request_options/group_id` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `request_options/jobs_allowlist` list-of-types was widened by adding types `null` to media type `application/json`
  - …8 more
- …earlier changes not shown

[Full history](https://skmtc.dev/google/apis/turbinia-api-server/changes/api/request/post.md)

---

[API](https://skmtc.dev/google/apis/turbinia-api-server.md) · [All operations](https://skmtc.dev/google/apis/turbinia-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/turbinia-api-server/revisions/207d6275cb53/schema)