Skip to content
REST API

Team Part Endpoint

Upsert or remove team part numbers and notes for indexed parts.
POST   https://api.elexess.com/functions/v1/team-part
DELETE https://api.elexess.com/functions/v1/team-part
Team part numbers are now team items, which can hold several approved part numbers per item. Team admins manage them on the Items page of the dashboard, including CSV import and export. This endpoint keeps working for one item per part. Read items with all their part numbers through the items endpoint; the parts and watchlist endpoints also return them in their team_items field.

Authentication

  • JWT only
  • Team API tokens (el_live_*) are not allowed for write operations

POST Body

{
  "part_id": 12345,
  "team_part_number": "ERP-4588",
  "note": "Approved substitute available",
  "team_id": 7
}

Notes:

  • team_id is optional. If omitted, the API uses the caller's first active team.
  • team_part_number must be non-empty and at most 128 characters.
  • This endpoint works on items entered by hand (in the dashboard or through this endpoint). If one of them already uses the part, that item is renamed. Otherwise a new item is created with the part as its only part number.
  • Imported items and items managed by your integration are never changed through this endpoint.

DELETE removes the part from the hand-entered item that uses it. An item left without part numbers is deleted.

DELETE Body

{
  "part_id": 12345,
  "team_id": 7
}

Responses

POST

id is the team item's id.

{
  "id": 54,
  "success": true
}

DELETE

{
  "removed": true,
  "success": true
}

Error Responses

  • 400: invalid payload or membership violation
  • 401: missing or invalid auth token
  • 403: write attempted with API token
  • 409: several hand-entered items use the part; a team owner or admin can edit them on the Items page
  • 500: internal error