agency-time

POST `/v1/agency/time/projects`

Create a time-tracking project.

प्रमाणीकरण

एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। कुञ्जीसँग agency.time.manage अनुमति हुनुपर्छ; अनुमति नभएको कुञ्जीलाई 404 होइन, 403 मार्फत अस्वीकार गरिन्छ।

तपाईंको संस्थाको आइडी राख्ने ठाउँ

यो इन्डपोटले JSON बडीमा एक फिल्डको रूपमा org_id लिन्छ।

तपाईंको संस्थाको आइडी (ID) तपाईंको ड्यासबोर्डमा रहेको API कुञ्जीहरू (keys) स्क्रिनमा, कुञ्जीको छेउमा हुन्छ। तपाईंले गर्ने प्रत्येक कलमा यही आइडी प्रयोग हुन्छ।

प्रयास गर्नुहोस्

कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।

curl -X POST https://api.zinndigital.com/v1/agency/time/projects \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <string> }'

लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्

विवरणहरू

Requires `agency.time.manage` and the `agency_project_board` entitlement. `currency` is set on the PROJECT rather than derived from whichever rate card wins, because an invoice has exactly one currency: a project whose rates disagreed would produce a document that cannot be issued. A rate card in another currency is refused rather than converted — FX is a driver decision, not a timesheet's.

अनुरोध बडी

नाम	प्रकार	आवश्यक	यो के हो
`name`	`string`	हुन्छ	—
`client_id`	`string`	हैन	—
`board_id`	`string`	हैन	—
`currency`	`string`	हैन	—
`org_id`	`string`	हैन	—

प्रतिक्रिया

नाम	प्रकार	आवश्यक	यो के हो
`id`	`string`	हुन्छ	—
`name`	`string`	हुन्छ	—
`client_id`	`string`	हुन्छ	The agency's client this work is for, in the agency invoicing suite. `null` means internal work — reported on, never invoiced.
`board_id`	`string`	हुन्छ	The agency project board this work is run on, when there is one.
`currency`	`string`	हुन्छ	ISO currency this project's work is billed in. On the project because an invoice has exactly one currency; a rate card in another currency is refused rather than converted.
`archived`	`boolean`	हुन्छ	—
`created_at`	`string`	हुन्छ	—

यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू

401 · 403 · 422

POST /v1/agency/time/projects