> ## Documentation Index > Fetch the complete documentation index at: https://docs.doers.sh/llms.txt > Use this file to discover all available pages before exploring further. # What is shared with you > Every project or area you reach and do not own: through a grant, or through the workspace-wide row in a workspace you sit in. Each with your level, whose it is, and where it lives — the "Shared with you" section of the sidebar. ## OpenAPI ````yaml https://api.doers.sh/openapi.json get /v2/access/shared openapi: 3.1.0 info: title: Doers API version: 2.0.0 description: >- The open API of Doers: tasks, projects, areas, prioritised context and the day's plan. ## Authentication Every route requires a bearer token, generated from **Settings > API & MCP** in the app: ``` Authorization: Bearer pc_… ``` ## Two date fields, not to be confused - `when` — the **schedule**: `today`, `anytime` (Later), `someday` (Future) or a date. - `deadline` — the **commitment**, independent of the schedule. ## Time zone The server reasons in UTC and does not know yours. Send the `X-PC-Today: YYYY-MM-DD` header (or the `day` argument where it exists) so dated operations use your local day. ## MCP server The same token gives access to the [Model Context Protocol](https://modelcontextprotocol.io) server at `POST https://doers.sh/mcp`, which exposes the same operations as tools for Claude, Cursor and other compatible clients. servers: - url: https://api.doers.sh description: Production. security: - bearerAuth: [] tags: - name: Tasks - name: Projects - name: Areas - name: Headings - name: Comments - name: Realtime - name: Devices - name: Context - name: Plan - name: Sessions - name: Rounds - name: Journal - name: Habits - name: Stats - name: Users - name: Profiles - name: Workspaces - name: Access - name: Activity - name: Tokens - name: Referrals - name: Files - name: Connections - name: Collaborators - name: Links - name: Packages - name: Installs - name: Billing - name: Calendar - name: Coach - name: Marketplace paths: /v2/access/shared: get: tags: - Access summary: What is shared with you description: >- Every project or area you reach and do not own: through a grant, or through the workspace-wide row in a workspace you sit in. Each with your level, whose it is, and where it lives — the "Shared with you" section of the sidebar. operationId: listSharedTargets responses: '200': description: Success. content: application/json: schema: type: object properties: targets: type: array items: oneOf: - type: object properties: targetId: type: string name: type: string role: type: string enum: - reader - commenter - editor - owner description: Yours on it. sharer: type: object properties: id: type: string username: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' image: anyOf: - type: string - type: 'null' required: - id - username - name - email - image additionalProperties: false description: Whose it is. workspace: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false description: Where it lives. targetKind: type: string const: project project: type: object properties: id: type: string name: type: string areaId: anyOf: - type: string - type: 'null' status: type: string enum: - active - done - archived deadline: anyOf: - type: string - type: 'null' notes: type: string order: type: number description: >- Manual position. Fractional values are valid; lower sorts first. accessRole: description: Your effective role on this project. type: string enum: - owner - editor - commenter - reader required: - id - name - areaId - status - deadline - notes - order additionalProperties: false required: - targetId - name - role - sharer - workspace - targetKind - project additionalProperties: false - type: object properties: targetId: type: string name: type: string role: type: string enum: - reader - commenter - editor - owner description: Yours on it. sharer: type: object properties: id: type: string username: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' image: anyOf: - type: string - type: 'null' required: - id - username - name - email - image additionalProperties: false description: Whose it is. workspace: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false description: Where it lives. targetKind: type: string const: area area: type: object properties: id: type: string name: type: string hue: anyOf: - type: integer minimum: 0 maximum: 360 description: >- Anodized metal hue angle from 0 to 360 degrees. - type: 'null' icon: anyOf: - type: string - type: 'null' description: Phosphor icon name. notes: type: string archived: type: boolean order: type: number description: >- Manual position. Fractional values are valid; lower sorts first. accessRole: description: Your effective role on this area. type: string enum: - owner - editor - commenter - reader required: - id - name - hue - icon - notes - archived - order additionalProperties: false required: - targetId - name - role - sharer - workspace - targetKind - area additionalProperties: false tasks: type: array items: type: object properties: id: type: string title: type: string notes: type: string status: type: string enum: - open - done - archived priority: type: integer minimum: -9007199254740991 maximum: 9007199254740991 when: oneOf: - type: object properties: kind: type: string const: today required: - kind additionalProperties: false - type: object properties: kind: type: string const: anytime required: - kind additionalProperties: false - type: object properties: kind: type: string const: someday required: - kind additionalProperties: false - type: object properties: kind: type: string const: date date: type: string hasTime: type: boolean time: anyOf: - type: string - type: 'null' required: - kind - date - hasTime additionalProperties: false description: >- How the task is scheduled (distinct from its `deadline`). deadline: anyOf: - type: string - type: 'null' description: Due date `YYYY-MM-DD`, or `null`. projectId: anyOf: - type: string - type: 'null' areaId: anyOf: - type: string - type: 'null' headingId: anyOf: - type: string - type: 'null' description: >- Heading grouping the task, or `null` if it sits above them all. tags: type: array items: type: string checklist: type: array items: type: object properties: id: type: string label: type: string done: type: boolean required: - id - label - done additionalProperties: false completedAt: anyOf: - type: number - type: 'null' durationMin: anyOf: - type: number - type: 'null' kind: type: string enum: - task - event repeat: anyOf: - type: object properties: every: type: integer minimum: 1 maximum: 365 description: 'The multiplier: 2 × week.' unit: type: string enum: - day - week - month - year mode: type: string enum: - calendar - after description: >- `calendar`: the next one starts from the scheduled date. `after`: from ticking. weekdays: description: >- ISO weekdays (1 = Monday … 7 = Sunday) the weekly rule fires on. Only valid with unit "week". minItems: 1 maxItems: 7 type: array items: type: integer minimum: 1 maximum: 7 required: - every - unit - mode additionalProperties: false description: >- Repeat rule. Ticking the task creates the next occurrence. - type: 'null' visibility: type: string enum: - public - anonymized - private description: >- Who sees this task on shared and social surfaces: public shows title and project, anonymized shows only the area, private shows nothing. New tasks default to private. order: type: number description: >- Manual position. Fractional values are valid; lower sorts first. notePath: anyOf: - type: string maxLength: 1024 description: >- Path of a note in the local markdown vault, relative to its root (`Projects/Launch.md`). When set, the app shows that note **instead of** the `notes` field. Do not invent one: it names a file on the user's machine. - type: 'null' conversationPath: anyOf: - type: string maxLength: 1024 description: >- Path of the Atelier conversation this task is delegated to, relative to the vault root (`Agents/Reel scripter/Conversations/….md`). The agent is derived from the path. Do not invent one: it names a file on the user's machine. - type: 'null' assigneeId: anyOf: - type: string - type: 'null' description: >- Who it is assigned to: one person who reaches the task, or nobody. assignee: anyOf: - type: object properties: id: type: string username: anyOf: - type: string - type: 'null' name: anyOf: - type: string - type: 'null' email: anyOf: - type: string - type: 'null' image: anyOf: - type: string - type: 'null' required: - id - username - name - email - image additionalProperties: false - type: 'null' description: The same person, as the row draws them. accessRole: description: Your effective role on this task. type: string enum: - owner - editor - commenter - reader required: - id - title - notes - status - priority - when - deadline - projectId - areaId - headingId - tags - checklist - completedAt - durationMin - kind - repeat - visibility - order - notePath - conversationPath - assigneeId - assignee additionalProperties: false description: >- The open tasks of those targets, in their order, up to one page; the paginated list is `listTasks` with `sharedWithMe`. Here so a page draws in one read. required: - targets - tasks additionalProperties: false '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' components: responses: BadRequest: content: application/json: schema: $ref: '#/components/schemas/Error' description: >- Invalid request — unreadable body, out-of-range field or unknown parameter. Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Token missing, unknown or revoked. TooManyRequests: content: application/json: schema: $ref: '#/components/schemas/Error' description: Too many requests. `Retry-After` says how many seconds to wait. schemas: Error: type: object properties: error: type: object properties: code: type: string description: Stable machine-readable code. message: type: string description: Human-readable message. details: type: array description: Per-field detail, present on validation errors. items: type: object properties: field: type: string message: type: string required: - field - message required: - code - message required: - error securitySchemes: bearerAuth: type: http scheme: bearer description: A `pc_…` token generated from Settings > API & MCP. ````