Deep Research Profiles

Upsert

post

Upsert a Deep Research Profile entry.

Creates a new Deep Research Profile if the provided id does not exist, or updates the existing Deep Research Profile with the given id.

Args: request (DRProfile): The Deep Research Profile data to insert or update. db (AsyncSession): The database session dependency.

Returns: JSONResponse: A JSON response containing the Deep Research Profile data that was upserted.

Raises: HTTPException: If the operation encounters an unexpected error (not currently implemented, but can be added for error handling).

Notes: - Uses FastCRUD for abstracted DB operations. - Relies on the id field to determine insert vs update.

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Deep Research Profile model.

codenamestringRequired

typestring · enumRequiredPossible values:

titlestringRequired

descriptionstringRequired

parametersany ofRequired

or

updated_timestring · date-timeOptionalDefault: 2025-12-02T17:36:18.468511

idintegerRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/dr-profiles/upsert

HTTPcURLJavaScriptPython

POST /dr-profiles/upsert HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 158

{
  "codename": "text",
  "type": "Assafelovic POST /research",
  "title": "text",
  "description": "text",
  "parameters": [],
  "updated_time": "2025-12-02T17:36:18.468511",
  "id": 1
}

No content

Get

get

Read multiple DRProfileModel rows from the database.

• Use page & itemsPerPage for paginated results

• Use offset & limit for specific ranges

• Returns paginated response when using page/itemsPerPage

• Returns simple list response when using offset/limit

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Query parameters

offsetany ofOptional

Offset for unpaginated queries

integerOptional

or

nullOptional

limitany ofOptional

Limit for unpaginated queries

integerOptional

or

nullOptional

pageany ofOptional

Page number

integerOptional

or

nullOptional

itemsPerPageany ofOptional

Number of items per page

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

Responseany of

or

422

Validation Error

application/json

get

/dr-profiles

HTTPcURLJavaScriptPython

GET /dr-profiles HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "id": 1,
      "codename": "text",
      "type": "Assafelovic POST /research",
      "title": "text",
      "description": "text",
      "parameters": [],
      "updated_time": "2026-01-14T04:30:14.435Z"
    }
  ],
  "total_count": 1,
  "has_more": true,
  "page": 1,
  "items_per_page": 1
}

Create

post

Create a new DRProfileModel row in the database.

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Body

application/json

Create Deep Research Profile model.

codenamestringRequired

typestring · enumRequiredPossible values:

titlestringRequired

descriptionstringRequired

parametersany ofRequired

or

updated_timestring · date-timeOptionalDefault: 2025-12-02T17:36:18.468511

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

/dr-profiles

HTTPcURLJavaScriptPython

POST /dr-profiles HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "codename": "text",
  "type": "Assafelovic POST /research",
  "title": "text",
  "description": "text",
  "parameters": [],
  "updated_time": "2025-12-02T17:36:18.468511"
}

No content

Get

get

Read a single DRProfileModel row from the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get

/dr-profiles/{id}

HTTPcURLJavaScriptPython

GET /dr-profiles/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "id": 1,
  "codename": "text",
  "type": "Assafelovic POST /research",
  "title": "text",
  "description": "text",
  "parameters": [],
  "updated_time": "2026-01-14T04:30:14.435Z"
}

Delete

delete

Delete a DRProfileModel row from the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

delete

/dr-profiles/{id}

HTTPcURLJavaScriptPython

DELETE /dr-profiles/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Update

patch

Update an existing DRProfileModel row in the database by its primary keys: ['id'].

Required scopes

This endpoint requires the following scopes:

• : Read Permissions

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

idintegerRequired

Body

application/json

Create Deep Research Profile model.

codenamestringRequired

typestring · enumRequiredPossible values:

titlestringRequired

descriptionstringRequired

parametersany ofRequired

or

updated_timestring · date-timeOptionalDefault: 2025-12-02T17:36:18.468511

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

patch

/dr-profiles/{id}

HTTPcURLJavaScriptPython

PATCH /dr-profiles/{id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "codename": "text",
  "type": "Assafelovic POST /research",
  "title": "text",
  "description": "text",
  "parameters": [],
  "updated_time": "2025-12-02T17:36:18.468511"
}

No content