API Reference (v2)Parts

Create part

Create a new part. Optionally create with a revision. Part numbers are matched case-insensitively (e.g., "PART-001" and "part-001" are considered the same).

Access

API Key	Access Level	Description
User	Full	Users can create parts
Station	Full	Stations can create parts

Endpoint

POST/v2/parts

Authorization

AuthorizationBearer <token>

API key for authentication. Use format: Bearer YOUR_API_KEY

In: header

Request Body

numberstring

Unique identifier number for the part.

Match^[a-zA-Z0-9_.:+-]+$

Length1 <= length <= 60

name?string

Human-readable name for the part. If not provided, a default name will be used.

Length1 <= length <= 255

revision_number?string

Revision identifier for the part version. If not provided, default revision identifier will be used.

Match^[a-zA-Z0-9_.:+-]+$

Length1 <= length <= 60

Response Body

from tofupilot.v2 import TofuPilot

# Initialize the TofuPilot client
client = TofuPilot()

# Execute the operation
result = client.parts.create(
    number="PCB-V2.0"
)

# Handle response
print(result)

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "message": "Unauthorized",
  "code": "UNAUTHORIZED",
  "issues": []
}

{
  "message": "Conflict",
  "code": "CONFLICT",
  "issues": []
}

{
  "message": "Internal server error",
  "code": "INTERNAL_SERVER_ERROR",
  "issues": []
}

How is this guide?

Remove sub-unit DELETE

Remove a sub-unit relationship from a parent unit by serial number. Only unlinks the parent-child relationship; neither unit is deleted from the system.

Get part GET

Retrieve a single part by its number, including all revisions, metadata, and linked units. Part numbers are matched case-insensitively.