> ## Documentation Index > Fetch the complete documentation index at: https://www.presolve.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a task > Requires the `tasks:write` scope. Mutations require an `X-Idempotency-Key` header (responses are stored for replay; reusing a key with a different request returns 409 `IDEMPOTENCY_CONFLICT`). Rate tier: `write`. ## OpenAPI ````yaml /openapi.json post /api/v1/tasks openapi: 3.1.0 info: title: Grand Charter Public API version: 1.0.0 description: >- Org-scoped integration API for the Grand Charter legal platform. Authenticate every request with an integration API key in the `x-api-key` header. Keys are created in the attorney portal under **Settings → Integrations → API Credentials** (or by platform admins) and carry an explicit list of scopes; each operation below names its required scope (`x-required-scope`). Conventions: JSON bodies/responses in camelCase; money in integer cents; ISO-8601 UTC timestamps; keyset cursor pagination (`after`, `limit` → `nextCursor`); errors use `{ success: false, error, code }`. Idempotency: most mutations require an `X-Idempotency-Key` header — each operation description below says so explicitly. Exceptions that do NOT consume the header (retrying them can create duplicates): `POST /leads`, `PATCH /leads/{leadId}`, and `PATCH /cases/{caseId}`. servers: - url: https://www.presolve.com description: Production security: - integrationApiKey: [] tags: - name: Platform - name: Org & Team - name: Cases - name: Leads - name: Clients - name: Contacts - name: Documents - name: Notes - name: Tasks - name: Calendar - name: Deadlines - name: Intake - name: E-Sign - name: Billing - name: Settlement Funds - name: Referrals - name: Communications - name: Medical - name: Reports & Exports - name: Events & Webhooks paths: /api/v1/tasks: post: tags: - Tasks summary: Create a task description: >- Requires the `tasks:write` scope. Mutations require an `X-Idempotency-Key` header (responses are stored for replay; reusing a key with a different request returns 409 `IDEMPOTENCY_CONFLICT`). Rate tier: `write`. operationId: post_tasks parameters: - name: X-Idempotency-Key in: header required: true description: >- Stable caller-chosen key (max 200 chars) making the mutation safely retryable. schema: type: string maxLength: 200 requestBody: required: true content: application/json: schema: type: object properties: caseId: type: string minLength: 1 maxLength: 200 title: type: string minLength: 1 maxLength: 500 description: type: string maxLength: 10000 dueAt: type: string assigneeIds: type: array items: type: string minLength: 1 maxLength: 200 maxItems: 50 default: [] followerIds: type: array items: type: string minLength: 1 maxLength: 200 maxItems: 50 default: [] priority: type: string minLength: 1 maxLength: 50 taskType: type: string minLength: 1 maxLength: 100 required: - title - dueAt additionalProperties: false responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/TaskDetailResponse' '400': description: Validation failed (VALIDATION_FAILED). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Missing, invalid, or expired API key (UNAUTHORIZED). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: API key lacks the required scope (FORBIDDEN). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found in the caller’s organization (NOT_FOUND). content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '409': description: >- Conflict: invalid state transition, duplicate entry, stale revision, or idempotency conflict. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded (RATE_LIMITED). Honor Retry-After. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - integrationApiKey: [] components: schemas: TaskDetailResponse: type: object properties: success: type: boolean const: true task: $ref: '#/components/schemas/Task' required: - success - task ErrorResponse: type: object properties: success: type: boolean const: false error: type: string description: >- Human-readable error message. 5xx responses are always scrubbed to "Internal server error". code: type: string description: >- Stable machine-readable error code (ErrorCode), e.g. UNAUTHORIZED, FORBIDDEN, VALIDATION_FAILED, NOT_FOUND, INVALID_STATE_TRANSITION, DUPLICATE_ENTRY, STALE_REVISION, IDEMPOTENCY_IN_PROGRESS, IDEMPOTENCY_CONFLICT, RATE_LIMITED, INTERNAL_ERROR. required: - success - error - code Task: type: object properties: id: type: string organizationId: type: - string - 'null' caseId: type: - string - 'null' title: type: string description: type: - string - 'null' status: type: string description: Stable task status name priority: type: - string - 'null' taskType: type: - string - 'null' dueAt: type: string description: ISO-8601 UTC timestamp startAt: type: string description: ISO-8601 UTC timestamp isAllDay: type: boolean ownerAttorneyId: type: - string - 'null' inProgressAt: type: - string - 'null' description: ISO-8601 UTC timestamp completedAt: type: - string - 'null' description: ISO-8601 UTC timestamp completedBy: type: - string - 'null' cancelledAt: type: - string - 'null' description: ISO-8601 UTC timestamp cancelledBy: type: - string - 'null' assignees: type: array items: type: object properties: attorneyId: type: string firstName: type: string lastName: type: string email: type: string required: - attorneyId - firstName - lastName - email followers: type: array items: type: object properties: attorneyId: type: string firstName: type: string lastName: type: string email: type: string required: - attorneyId - firstName - lastName - email createdAt: type: string description: ISO-8601 UTC timestamp updatedAt: type: string description: ISO-8601 UTC timestamp required: - id - organizationId - caseId - title - description - status - priority - taskType - dueAt - startAt - isAllDay - ownerAttorneyId - inProgressAt - completedAt - completedBy - cancelledAt - cancelledBy - assignees - followers - createdAt - updatedAt securitySchemes: integrationApiKey: type: apiKey in: header name: x-api-key description: >- Org-issued integration API key (service account credential). The plaintext secret is shown once at creation. ````