> ## Documentation Index > Fetch the complete documentation index at: https://docs.clinikapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Task ## OpenAPI ````yaml post /v1/tasks openapi: 3.1.0 info: title: ClinikAPI version: 1.0.0 description: > ClinikAPI is a managed healthcare infrastructure platform providing a developer-friendly REST API for storing, querying, and managing clinical data using the FHIR R4 standard. ## Authentication All endpoints (except `/v1/metadata` and `/health`) require an API key via the `x-api-key` header. - Production keys: `clk_live_*` - Test/sandbox keys: `clk_test_*` ## Response Format All responses are wrapped in `{ data: T, meta: { requestId, timestamp, status, rateLimitTotal, rateLimitRemaining, rateLimitReset } }`. ## Rate Limits Rate limits are plan-based and returned in response headers: - `X-RateLimit-Limit` — total requests allowed per window - `X-RateLimit-Remaining` — requests remaining - `X-RateLimit-Reset` — seconds until window resets ## Overages Requests beyond your plan limit are charged at $0.003/request. contact: name: ClinikAPI Support email: support@clinikapi.com url: https://clinikapi.com license: name: Proprietary servers: - url: https://api.clinikapi.com description: Production - url: http://localhost:3000 description: Local development security: - ApiKeyAuth: [] tags: - name: System description: Health check and metadata - name: Patients description: Patient demographics and records - name: Practitioners description: Healthcare providers and clinicians - name: PractitionerRoles description: Practitioner roles, specialties, and availability - name: Encounters description: Clinical visits and interactions - name: Observations description: Vitals, lab values, and clinical measurements - name: Medications description: Drug catalog entries - name: Appointments description: Scheduling and booking - name: Prescriptions description: Medication orders (MedicationRequest) - name: Intakes description: Questionnaire responses and intake forms - name: Consents description: Privacy and treatment consent directives - name: Labs description: Diagnostic reports and lab results - name: Notes description: Clinical notes and documents (DocumentReference) - name: Assessments description: Clinical impressions and evaluations - name: Documents description: Structured clinical documents (Composition) - name: Devices description: Medical devices, equipment, and implantable hardware - name: DeviceRequests description: Orders and proposals for device use - name: DeviceUseStatements description: Records of device use on patients - name: Goals description: Patient care goals and targets - name: Invoices description: Healthcare billing invoices - name: MedicationDispenses description: Pharmacy medication dispensing records - name: MedicationKnowledge description: Drug reference data and formulary information - name: MedicationStatements description: Patient-reported medication usage records - name: PaymentNotices description: Payment status notifications between payers and providers - name: PaymentReconciliations description: Detailed payment settlement information with line-item breakdowns - name: Specimens description: Biological samples collected from patients for laboratory testing - name: ImagingStudies description: Radiology and diagnostic imaging exams with series-level detail - name: EnrollmentRequests description: Insurance enrollment requests for patients - name: EnrollmentResponses description: Insurer responses to enrollment requests - name: ImmunizationEvaluations description: Evaluation of immunization events against protocol requirements - name: Media description: Clinical images, videos, and audio recordings - name: AuditEvents description: Security-relevant event records for compliance and audit trails - name: Measures description: Quality measures and clinical performance metric definitions - name: MeasureReports description: Results of evaluating quality measures against populations or patients - name: ImmunizationRecommendations description: Patient-specific vaccine recommendations based on immunization history - name: Bulk description: Bulk import and export operations - name: FHIR Passthrough description: Raw FHIR R4 access with tenant isolation paths: /v1/tasks: post: tags: - Tasks summary: Create task operationId: createTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TaskCreate' responses: '201': description: Task created '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: TaskCreate: type: object required: - status - intent properties: status: type: string enum: - draft - requested - received - accepted - rejected - ready - cancelled - in-progress - on-hold - failed - completed intent: type: string enum: - unknown - proposal - plan - order - original-order - reflex-order - filler-order - instance-order - option statusReason: type: string maxLength: 500 businessStatus: type: string maxLength: 200 description: Business-specific status (e.g. Specimen collected) priority: type: string enum: - routine - urgent - asap - stat code: type: string maxLength: 200 description: Task type code description: type: string maxLength: 2000 focusId: type: string description: What the task is acting on patientId: type: string description: Beneficiary of the task encounterId: type: string executionPeriod: type: object properties: start: type: string format: date-time end: type: string format: date-time authoredOn: type: string format: date-time requesterId: type: string ownerId: type: string reasonCode: type: string maxLength: 500 note: type: string maxLength: 2000 basedOn: type: array items: type: string partOf: type: array items: type: string input: type: array items: type: object required: - type properties: type: type: string valueString: type: string valueBoolean: type: boolean valueInteger: type: integer output: type: array items: type: object required: - type properties: type: type: string valueString: type: string valueBoolean: type: boolean valueInteger: type: integer restriction: type: object properties: repetitions: type: integer period: type: object properties: start: type: string end: type: string recipientIds: type: array items: type: string Error: type: object properties: error: type: string message: type: string code: type: string requestId: type: string issues: type: array items: type: object properties: severity: type: string code: type: string diagnostics: type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Your ClinikAPI secret key (clk_live_* or clk_test_*) ````