REST API on every paid plan. Submit P&ID drawings, poll extraction status, fetch structured results. Create keys under Dashboard, API Keys.
All requests carry an Authorization header with a bearer token. Keys are scoped per workspace and can be revoked instantly from /dashboard/api-keys.
Authorization: Bearer ts_your_api_keyThree endpoints cover the full extraction loop. Submit a drawing, poll for status, fetch the results when complete.
Submit a P&ID drawing for extraction. Accepts multipart form data with a file field (PDF, PNG, JPG, or TIFF) and an optional workspace_id.
curl -X POST https://api.tagsight.io/v1/extract \
-H "Authorization: Bearer $TS_KEY" \
-F "file=@drawing.pdf"{
"job_id": "j_a8f2d9",
"status": "queued"
}Poll extraction status. Returns a progress value between 0 and 1. Status values: queued, processing, completed, failed.
curl https://api.tagsight.io/v1/extract/j_a8f2d9 \
-H "Authorization: Bearer $TS_KEY"{
"job_id": "j_a8f2d9",
"status": "completed",
"progress": 1.0
}Fetch structured results once extraction completes. Returns instruments, equipment, lines, and connections arrays.
curl https://api.tagsight.io/v1/extract/j_a8f2d9/results \
-H "Authorization: Bearer $TS_KEY"{
"job_id": "j_a8f2d9",
"instruments": [
{
"tag_number": "PT-101",
"instrument_type": "PT",
"signal_class": "AI",
"confidence": 0.98,
"page_number": 1
},
{
"tag_number": "XV-2301",
"instrument_type": "XV",
"signal_class": "DO",
"confidence": 0.95,
"page_number": 1
}
],
"equipment": [
{ "tag": "P-101", "equipment_type": "pump" }
],
"lines": [
{ "line_number": "4\"-CS-101-A1A", "nominal_size": "4 inch" }
],
"connections": [
{ "from_tag": "PT-101", "to_tag": "P-101", "type": "measurement" }
]
}Configure endpoints at Dashboard, Webhooks. Three events are available: processing.completed, processing.failed, and test.ping. Failed deliveries retry with exponential backoff. If an endpoint continues to fail the webhook is auto-disabled and can be re-enabled from the dashboard.
Every delivery includes an X-Webhook-Signature header. Payloads are signed via HMAC-SHA256 using the workspace webhook secret. Verify before processing:
import hmac
import hashlib
def verify_webhook(
secret: str,
raw_body: bytes,
signature_header: str,
) -> bool:
expected = hmac.new(
secret.encode(),
raw_body,
hashlib.sha256,
).hexdigest()
return hmac.compare_digest(expected, signature_header)Tagsight is reachable via the Model Context Protocol for any MCP-compatible client. See the MCP reference for the full seven-tool catalogue, client configuration snippets, and security notes.
400file field, or unsupported format.401402422429500API keys are available on every paid plan. Create one from the dashboard, or talk to us about an Enterprise key set.