Skip to main content
PATCH
/
api
/
dataframer
/
red-team-specs
/
{spec_id}
Update red team spec
curl --request PATCH \
  --url https://df-api.dataframer.ai/api/dataframer/red-team-specs/{spec_id}/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "concerns": "Should not provide medical diagnoses, prescription recommendations, or discuss specific medications"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "domain_description": "<string>",
  "app_description": "<string>",
  "concerns": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "company_name": "<string>",
  "created_by": 123,
  "created_by_email": "<string>"
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: "Bearer YOUR_API_KEY"

Path Parameters

​
spec_id
string<uuid>
required

UUID of the red team spec

Body

application/json

Request body for updating a red team spec (all fields optional)

​
name
string

New name for the spec (will be converted to snake_case)

​
domain_description
string

Updated domain description

​
app_description
string

Updated application description

​
concerns
string

Updated security concerns

Response

Red team spec updated successfully

A red team specification defining the application context for adversarial prompt generation

​
id
string<uuid>

Unique identifier for the red team spec

​
name
string

Name of the red team spec (auto-converted to snake_case)

​
domain_description
string

Description of the domain or industry the application operates in

​
app_description
string

Description of the application being tested, including its purpose and functionality

​
concerns
string | null

Specific security concerns or behaviors to focus on during red teaming

​
created_at
string<date-time>

Timestamp when the spec was created

​
updated_at
string<date-time>

Timestamp when the spec was last modified

​
company_id
string<uuid>

ID of the company that owns this spec

​
company_name
string

Name of the company that owns this spec

​
created_by
integer

ID of the user who created this spec

​
created_by_email
string

Email of the user who created this spec