Agentic Platform
Documentation API reference Tools Skills

Tools

Speedworkers Versions

speedworkers_versions MCP

List the SpeedWorkers versions of the project (version number, production release date, last editor, comment)

List the SpeedWorkers settings versions of a project, most recent first. For each version: its number, when it was pushed to production (null if it never was, e.g. the current draft), the last user who edited it or pushed it, and the comment entered when it was pushed to production. Use a version number with the speedworkers_config agent to get the full configuration of that version.

Playground

POST
item

No fields.

Credits

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Example
{}

Response

object
Properties
versions array required

SpeedWorkers versions, most recent first

Items: SpeedworkersVersionSummary

Example
{
  "versions": [
    {
      "version": 0,
      "date_released_on_production": "string",
      "last_edited_by": "string",
      "comment": "string"
    }
  ]
}

Type Definitions

1 type

These are the available sub-object types that can be used in the properties above.

SpeedworkersVersionSummary object
#
version integer required

Version number, as shown in SpeedWorkers versioning

date_released_on_production string | null required

When this version was pushed to production (null if it never was, e.g. the current draft)

last_edited_by string required

Last user who edited this version (or pushed it to production)

comment string required

Comment entered when the version was pushed to production (empty if none)

Endpoints

POST http://agents.botify.com/{organization}/{project}/speedworkers_versions/process
POST http://agents.botify.com/{organization}/{project}/speedworkers_versions/batch_process
POST http://agents.botify.com/{organization}/{project}/speedworkers_versions/async_process
POST http://agents.botify.com/{organization}/{project}/speedworkers_versions/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/speedworkers_versions/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool speedworkers_versions. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata