Refine test description

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/testing-agent/refine \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "check that new projects show up on the dashboard"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/testing-agent/refine"

payload = { "description": "check that new projects show up on the dashboard" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'check that new projects show up on the dashboard'})
};

fetch('https://app.base44.com/api/apps/{app_id}/testing-agent/refine', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/testing-agent/refine",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'check that new projects show up on the dashboard'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/testing-agent/refine"

	payload := strings.NewReader("{\n  \"description\": \"check that new projects show up on the dashboard\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/testing-agent/refine")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"check that new projects show up on the dashboard\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/testing-agent/refine")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"check that new projects show up on the dashboard\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "Create a project",
  "goal": "Sign up, create a project called Launch, and check that it appears on the dashboard."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Testing

Refine test description

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Turns a rough description into a test name and a goal the testing agent can follow. Nothing is saved. Pass the result to Create test to add it.

This makes an AI call and usually answers within a few seconds. It’s billed by the length of description, so it usually costs a fraction of a credit. The call is refused when the workspace is out of credits.

This is limited to 20 requests per minute per caller for each app. Some workspaces have a different limit.

This endpoint accepts a personal API key belonging to a user with editor access to the app. Read-only keys and workspace API keys are refused.

POST

api

apps

{app_id}

testing-agent

refine

Refine test description

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/testing-agent/refine \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "check that new projects show up on the dashboard"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/testing-agent/refine"

payload = { "description": "check that new projects show up on the dashboard" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'check that new projects show up on the dashboard'})
};

fetch('https://app.base44.com/api/apps/{app_id}/testing-agent/refine', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/testing-agent/refine",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'description' => 'check that new projects show up on the dashboard'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/testing-agent/refine"

	payload := strings.NewReader("{\n  \"description\": \"check that new projects show up on the dashboard\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/testing-agent/refine")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"description\": \"check that new projects show up on the dashboard\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/testing-agent/refine")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"description\": \"check that new projects show up on the dashboard\"\n}"

response = http.request(request)
puts response.read_body

{
  "name": "Create a project",
  "goal": "Sign up, create a project called Launch, and check that it appears on the dashboard."
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id

string

required

ID of the app.

Body

application/json

description

string

required

Rough description of what to test, in your own words.

Required string length: 1 - 500

Example:

"check that new projects show up on the dashboard"

Response

The suggested name and goal.

A test name and goal written from a rough description.

name

string

required

Short name for the test.

Example:

"Create a project"

goal

string

required

The goal, rewritten as steps the testing agent can follow.

Example:

"Sign up, create a project called Launch, and check that it appears on the dashboard."

Base44 APIs

Apps API (Beta)

Workspace API (Beta)

Superagents API (Beta)

Monitoring API

Audit Logs API

Refine test description

Authorizations

Path Parameters

Body

Response