API
Connect Paximal to Your Systems
Submit invention disclosures from your own tools with the intake API, and build agents on the MCP server.
Project Intake API
Create, Upload, Submit
Three requests turn a record in your idea portal or ticketing system into a Paximal matter with its documents attached, ready for an attorney.
- Direct File Upload
- Original files are uploaded to the matter using short-lived, narrowly scoped credentials.
- Your Identifiers
- Include an external ID and your own reference so both systems can find the matter.
- Attorney-Initiated Work
- The API handles intake only. An attorney decides what happens next.
intake.sh
# 1. Create a project
curl -X POST https://next.paximal.com/api/v1/projects \
-H "Authorization: Bearer $PAXIMAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"project_reference": "RX-2207",
"invention_name": "Self-calibrating joint torque sensor",
"inventors": ["Dana Whitlock", "Priya Raman"],
"entity_name": "Northfield Robotics, Inc.",
"entity_type": "company",
"external_id": "IDEA-4471"
}'
# 2. Upload the original documents using the
# short-lived credentials in the response
# 3. Mark the project ready for the attorney
curl -X POST \
https://next.paximal.com/api/v1/projects/$PROJECT_ID/submit \
-H "Authorization: Bearer $PAXIMAL_API_KEY"Intake
Matters Arrive Where Attorneys Work
A submitted project appears in the attorney's workspace at the first step, the same as a matter created in the web app or through an AI assistant.
New matters
This week- WorkspaceReady
Upload in the browser
4 documents · just now
- AssistantReady
create_project over MCP
From a design-review thread
- Intake APIReady
POST /api/v1/projects
From the idea portal · IDEA-4471
However a matter arrives, it lands at the same first stage with its documents attached.
MCP Server
Build Agents on the Same Tools
The MCP server exposes every step of the workflow with explicit step, source and revision arguments. Requests are safe to retry, and original files are transferred directly.
View the MCP Tools
PaximalConnected to your assistantDesign review
Drift study
Calibration notes
Start a matter from these files. Run novelty and detectability, then draft a utility application.
Matter RX-2207 is open with your three documents.
- Invention disclosureComplete
- Novelty analysisRunning
- Detectability analysisRunning
- Application draftStarts when analyses finish
Does anything need my input?
One decision. Which should be the first independent claim?
Apparatus claim
A robotic joint assembly comprising a torque sensor and a controller…
Method claim
A method of calibrating a joint torque sensor, comprising…
Use the apparatus claim. Send me the draft once it is proofread.
Revision 2 is ready for your review.
Specification
Clean copy
Redline
Against Rev 1
Proofreading report
2 items for you
Frequently Asked Questions
Have another question? Email info@paximal.com.
Does submitting a project start any drafting?
No. The API creates the matter and attaches the documents. No drafting starts and no credits are used until an attorney starts a step in Paximal.How are API keys scoped?
Each key belongs to one user and one organization. Revoking a key blocks further requests immediately.How do we avoid duplicate projects on retry?
Send your own project reference. A repeated reference returns a conflict response that includes the existing project ID.Are there rate limits?
Yes. Requests are limited per user and organization. A rate-limited response includes a Retry-After header, and every response includes a request ID.How do we get access?
The intake API is enabled per organization. Contact us and we will enable it and share the developer guide.
Planning an Integration?
Tell us what you want to connect. We will enable the API for your organization and help with the first matter.
