Actions82
- Activity Event Actions
- Calendar Event Actions
- Comment Actions
- Company Actions
- Contract Actions
- Conversation Actions
- Exchange Rate Actions
- Invoice Actions
- KB Article Actions
- Knowledge Base Category Actions
- Monitoring Actions
- Purchase Request Actions
- Resource Actions
- Search Actions
- Secret Vault Actions
- SLA Actions
- Survey Actions
- Quotation Request Actions
- Terminal Recording Actions
- Ticket Actions
- User Actions
- Vendor Actions
- Wish Actions
- Work Log Actions
Purchase Request → Create
AI-generatedSummary
Create a new purchase request in Ayudala
Inputs
- title (required) — Title of the purchase request
- description (required) — Description of the purchase request
- company_id — Company ID (required for staff callers when the API key is not company-scoped)
- category — Procurement category
- currency — ISO currency code (default USD)
- justification — Business justification
- linked_ticket_id — Optional ticket to link
- linked_objective_id — Optional contract objective to link
- estimated_budget — Estimated total budget override
- itemsJson — JSON array of line items (category, description, quantity, unit, estimated_unit_price, notes)
Output shape
a single created purchase request object
Returns the created purchase request with its generated ID and timestamps; optional fields are included if provided; errors follow the standard error envelope.
Examples
Example 1: Create a purchase request for office chairs
title: 'Office Chairs'; description: 'Replace worn chairs'; currency: 'USD'; itemsJson: '[{"category":"Furniture","description":"Ergonomic Chair","quantity":10,"unit_price":150}]'
Example 2: Create a purchase request linked to ticket 12345
title: 'Conference Room Setup'; linked_ticket_id: 12345; justification: 'Setup for upcoming conference'; itemsJson: '[{"category":"IT","description":"Projector","quantity":1,"unit_price":800}]'
Example 3: Create a purchase request linked to an objective
title: 'Software License Renewal'; linked_objective_id: 789; category: 'Software'; itemsJson: '[{"category":"Software","description":"License Renewal","quantity":5,"unit_price":200}]'