Effect Level Management

Effect Level is a part of Effect and every request should include Effect ID as a path argument.

Create Level Variant

post

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

Body

application/json

titlestring · min: 1Required

descriptionstring | nullOptional

promptanyOptionalDefault: {}

statusall ofOptionalDefault: draft

string · enumOptional

• published - Published
• draft - Draft

Possible values:

simulation_periodstring | nullOptional

Responses

201Success

application/json

400Error

application/json

post

/api/v1/companies/{company_id}/effects/{effect_id}/variants/

HTTPcURLJavaScriptPython

POST /api/v1/companies/{company_id}/effects/{effect_id}/variants/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "title": "My first variant",
  "description": "My first variant that simulates age 30",
  "status": "draft",
  "prompt": {
    "age": 30
  },
  "simulation_period": "1 00:00:00"
}

{
  "id": "effvar_ZrIXw8kIHiJq3Umx",
  "effect_id": "eff_123",
  "updated_at": "2025-12-31T09:24:19.076104Z",
  "created_at": "2025-12-31T09:24:19.076110Z",
  "title": "My first variant",
  "description": "My first variant that simulates age 30",
  "prompt": {
    "age": 30
  },
  "status": "draft",
  "simulation_period": "1 00:00:00"
}

Update Level Variant

patch

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

variant_idstringRequired

Body

application/json

titlestring · min: 1Optional

descriptionstring | nullOptional

promptanyOptionalDefault: {}

statusall ofOptionalDefault: draft

string · enumOptional

• published - Published
• draft - Draft

Possible values:

simulation_periodstring | nullOptional

Responses

200Success

application/json

400Error

application/json

patch

/api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/

HTTPcURLJavaScriptPython

PATCH /api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 153

{
  "title": "My first variant",
  "description": "My first variant that simulates age 30",
  "status": "draft",
  "prompt": {
    "age": 30
  },
  "simulation_period": "1 00:00:00"
}

{
  "id": "effvar_ZrIXw8kIHiJq3Umx",
  "effect_id": "eff_123",
  "updated_at": "2025-12-31T09:24:19.076104Z",
  "created_at": "2025-12-31T09:24:19.076110Z",
  "title": "My first variant",
  "description": "My first variant that simulates age 30",
  "prompt": {
    "age": 30
  },
  "status": "draft",
  "simulation_period": "1 00:00:00"
}

List Level Variants

get

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

Query parameters

qstringOptional

A search term.

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Responses

200Success

application/json

400Error

application/json

get

/api/v1/companies/{company_id}/effects/{effect_id}/variants/

HTTPcURLJavaScriptPython

GET /api/v1/companies/{company_id}/effects/{effect_id}/variants/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": "effvar_ZrIXw8kIHiJq3Umx",
      "effect_id": "eff_123",
      "updated_at": "2025-12-31T09:24:19.076104Z",
      "created_at": "2025-12-31T09:24:19.076110Z",
      "title": "My first variant",
      "description": "My first variant that simulates age 30",
      "prompt": {
        "age": 30
      },
      "status": "draft",
      "simulation_period": "1 00:00:00"
    }
  ]
}

Get Effect Level Info

get

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

variant_idstringRequired

Responses

200Success

application/json

get

/api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/

HTTPcURLJavaScriptPython

GET /api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "id": "effvar_ZrIXw8kIHiJq3Umx",
  "effect_id": "eff_123",
  "updated_at": "2025-12-31T09:24:19.076104Z",
  "created_at": "2025-12-31T09:24:19.076110Z",
  "title": "My first variant",
  "description": "My first variant that simulates age 30",
  "prompt": {
    "age": 30
  },
  "status": "draft",
  "simulation_period": "1 00:00:00"
}

Delete Effect Level(s) in a Bulk Manner

post

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

Body

application/json

variants_idsstring[]Required

Responses

200Success

application/json

400Error

application/json

post

/api/v1/companies/{company_id}/effects/{effect_id}/variants/bulk-delete/

HTTPcURLJavaScriptPython

POST /api/v1/companies/{company_id}/effects/{effect_id}/variants/bulk-delete/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "variants_ids": [
    "text"
  ]
}

{
  "status": "text"
}

Duplicate Effect Level

post

Authorizations

PrivateTokenAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

company_idstring · uuidRequired

effect_idstringRequired

variant_idstringRequired

Body

application/json

titlestring | null · min: 1Optional

Responses

200Success

application/json

400Error

application/json

post

/api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/duplicate/

HTTPcURLJavaScriptPython

POST /api/v1/companies/{company_id}/effects/{effect_id}/variants/{variant_id}/duplicate/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "title": null
}

{
  "status": "text"
}