Project Tools

Projects group related jobs and track testers across them. Testers are auto-added to a project when they complete a job within it.

create_project

Create a new project.

Input

Field	Type	Required	Description
`name`	string	Yes	Project name (1–200 chars)
`description`	string	No	Description (max 2000 chars)

Output

{
  "project": {
    "id": "uuid",
    "name": "Landing Page Tests",
    "description": "All landing page A/B tests",
    "createdAt": "2025-01-15T09:00:00Z",
    "updatedAt": "2025-01-15T09:00:00Z"
  }
}

update_project

Update a project’s name or description.

Input

Field	Type	Required	Description
`project_id`	uuid	Yes	Project ID
`name`	string	No	New name
`description`	string \| null	No	New description (`null` to clear)

delete_project

Delete a project. Jobs within the project are unlinked, not deleted.

Input

Field	Type	Required
`project_id`	uuid	Yes

Output

{ "ok": true }

get_project

Get a project’s details including job and tester counts.

Input

Field	Type	Required
`project_id`	uuid	Yes

Output

{
  "project": {
    "id": "uuid",
    "name": "Landing Page Tests",
    "description": "All landing page A/B tests",
    "jobCount": 12,
    "testerCount": 47,
    "createdAt": "2025-01-15T09:00:00Z",
    "updatedAt": "2025-01-20T14:00:00Z"
  }
}

list_projects

List projects owned by the authenticated owner. Archived projects are excluded by default.

Input

Field	Type	Required	Description
`include_archived`	boolean	No	Include archived projects (default false)
`limit`	integer	No	Max results (1–100, default 50)

archive_project

Archive a project. Archived projects are hidden from default listings but their jobs remain active.

Input

Field	Type	Required
`project_id`	uuid	Yes

unarchive_project

Unarchive a previously archived project.

Input

Field	Type	Required
`project_id`	uuid	Yes

assign_job_to_project

Assign a job to a project, reassign to a different project, or remove from its current project.

Input

Field	Type	Required	Description
`job_id`	uuid	Yes	Job ID
`project_id`	uuid \| null	Yes	Project ID, or `null` to unlink

Output

{ "ok": true }

Tester Management

list_project_testers

List testers associated with a project. Testers are auto-added when they complete a job within the project.

Input

Field	Type	Required
`project_id`	uuid	Yes

Output

{
  "testers": [
    {
      "id": "record-uuid",
      "testerId": 123456,
      "trusted": false,
      "highValue": true,
      "blocked": false,
      "createdAt": "2025-01-15T10:00:00Z",
      "updatedAt": "2025-01-18T12:00:00Z"
    }
  ]
}

Tester IDs are numeric public IDs — owners never see tester PII.

add_project_tester

Manually add a tester to a project. Useful for pre-populating a tester pool before creating project_testers_only jobs.

Input

Field	Type	Required	Description
`project_id`	uuid	Yes	Project ID
`tester_id`	integer \| uuid	Yes	Tester public ID or UUID

update_project_tester

Update advisory flags on a project tester.

Input

Field	Type	Required	Description
`project_id`	uuid	Yes	Project ID
`tester_id`	integer \| uuid	Yes	Tester public ID or UUID
`trusted`	boolean	No	Mark as trusted
`high_value`	boolean	No	Mark as high value
`blocked`	boolean	No	Block from project jobs

remove_project_tester

Remove a tester from a project entirely. Deletes the project-tester record.

Input

Field	Type	Required	Description
`project_id`	uuid	Yes	Project ID
`tester_id`	integer \| uuid	Yes	Tester public ID or UUID