custom-tools

Create a custom tool

Create a custom tool in Draft status.

This creates the tool record only. Upload its source and build a version in separate requests.

post/api/custom-tools

Request

  • Base URL: https://app.tamarind.bio
  • URL: https://app.tamarind.bio/api/custom-tools
  • Auth: API key in header x-api-key

Request body

cpuinteger

Number of CPU cores allocated to each run. Defaults to 1.

descriptionstring

Short explanation of the tool. Defaults to an empty string.

displayNamestring

Human-readable name shown in the UI. Defaults to an empty string.

gpuType'None' | 'T4' | 'L4' | 'L40S' | 'A10' | 'A100'

GPU allocated to each run: "None", T4, L4, L40S, or A100. Defaults to "None". A10 is retired: it is still accepted and runs on L4.

memory'8Gi' | '12Gi' | '24Gi' | '32Gi' | '48Gi' | '64Gi' | '90Gi' | '96Gi' | '180Gi'

Memory allocated to each run. Defaults to "8Gi".

namestring required

A unique lowercase name containing letters, numbers, and hyphens.

Response

The created Tool.

autoPublishboolean required
canBuildboolean required
canEditboolean required
cpuinteger required
createdAtstring required
defaultVersionstring nullable required

The version used by default, such as v3. Null when no version is published.

descriptionstring required
displayNamestring required
estTimestring required
etagstring required

Opaque SDK-managed validator for this Tool snapshot.

functionsstring[] required
gpuType'None' | 'T4' | 'L4' | 'L40S' | 'A10' | 'A100' required
hasSourceboolean required
homeDiskGiinteger required
maxRuntimeSecondsinteger nullable required

Maximum runtime for a tool run, in seconds. Null means no tool-specific limit.

memory'8Gi' | '12Gi' | '24Gi' | '32Gi' | '48Gi' | '64Gi' | '90Gi' | '96Gi' | '180Gi' required
namestring required
paperUrlstring required
publishedboolean required
sourceDigeststring nullable required

SHA-256 digest of the current source archive after it has been admitted for a build. Null when the current source is unbuilt, absent, or hidden.

status'Draft' | 'Building' | 'Deployed' required
tagsstring[] required
updatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.