v2 Reference (Preview)/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).
API v2 Preview
The TofuPilot API v2.0 is currently in public preview and is subject to change as we stabilize until release (planned for Aug 2025).
Access
| API Key | Access Level | Description |
|---|---|---|
| User | Full | Users can create parts |
| Station | Full | Stations can create parts |
Endpoint
POST
/v2/partsAuthorizationBearer <token>
API key for authentication. Use format: Bearer YOUR_API_KEY
In: header
numberstring
Unique identifier number for the part.
Match
^[a-zA-Z0-9_.:+-]+$Length
1 <= length <= 60name?string
Human-readable name for the part. If not provided, a default name will be used.
Length
1 <= length <= 255revision_number?string
Revision identifier for the part version. If not provided, default revision identifier will be used.
Match
^[a-zA-Z0-9_.:+-]+$Length
1 <= length <= 60Response 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"
}{
"code": "CONFLICT",
"message": "A version with this tag already exists for the procedure",
"issues": []
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}How is this guide?